axiom
Skill3 starsChanged 3 months agoMITView on GitHub
AxiomCore front door - onboarding and module management. Actions - start (first-run setup, scaffolds the workspace), activate <module> (M2-voice, M2-brand, M3, M4), deactivate <module>, tier <simple|advanced>, language <code>, status, overview. Run start in any new folder to set up the system.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- civitai/civitaitheir own version, first seen Oct 8, 2026
- zhangyanxs/axiomtheir own version, first seen Apr 13, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- civitai/civitai★ 7.3ksame name
- zhangyanxs/axiom★ 5same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 7 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 12
If the requested action is ambiguous or contradictory, do NOT guess: flag it and ask for clarification before executing.
- Distinctive: line 34
If the action was unknown, say so first, then show the table.
- Distinctive: line 42
Read the workspace root. Three cases:
- Distinctive: line 63
Every skippable question accepts "skip" and moves on without discussion.
- Distinctive: line 67
Language: Ask which language to work in.
- Distinctive: line 75
Create in this order (skip whatever already exists):
- Distinctive: line 100
Run the module's mini-interview:
- Very specific: line 103
M3: check whether a Notion connector is available.
- Very specific: line 111
Remove the module's block from CLAUDE.md, flip the flag.
- Very specific: line 119
Update axiom-config.md, log, confirm.
- Very specific: line 128
Read axiom-config.md and report: language, tier, module table (active/inactive, M3 mode), nudge setting, last 5 nudge-log entries.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Task
Execute the requested action: $ARGUMENTS
Calling rule: /axiom <action> <arguments>.
If the requested action is ambiguous or contradictory, do NOT guess: flag it and ask for clarification before executing.
This skill owns axiom-config.md — all other skills read it, only this skill writes it. Templates used below ship in this skill folder: claude-kernel-template.md, soul-template.md, brand-config-template.md, axiom-config-template.md, getting-started-template.md.
If action is empty
Describe this skill: its purpose and the actions table from "overview". Do not execute anything.
If action is "overview" (or unknown)
| Argument | Action |
start | First-run onboarding: intro → interview → scaffold the workspace → first project |
activate <module> | Activate M2-voice, M2-brand, M3 (todos), or M4 (dev planning) |
deactivate <module> | Deactivate a module (flags only — user data is never deleted) |
tier <simple|advanced> | Switch disclosure tier |
language <code> | Change the working language |
status | Show configuration: language, tier, modules, recent nudges |
overview | This table |
If the action was unknown, say so first, then show the table.
If action is "start"
A. Detect state
Read the workspace root. Three cases:
- Fresh (no
axiom-config.md, empty folder or unfilled template copy): full flow below. - Partial (
axiom-config.mdexists but scaffolding or module files incomplete): report what exists, run only the missing parts. - Configured: report status and offer
activate/tier/languageinstead. Never re-scaffold over a working system.
B. Intro
Deliver this positioning (adapt wording to the conversation language, keep the order):
- Structure — "AxiomCore keeps everything you work on in one enforced system: numbered folders, consistent names, unique task IDs, and a wiki memory that mirrors it all. Nothing gets lost."
- Two work trees — "Everything you do lives in one of two trees: projects are temporary — a bounded goal, worked toward and finished once (a website launch, a market analysis); workstations are permanent — recurring routines repeated on a cadence (monthly reporting, ads monitoring). A finished project can become a workstation when its work turns routine."
- Disciplined workflow — "I never rush ahead: every task runs plan → your approval → step-by-step execution with validation. You stay in control."
- Health — "
/lintaudits the whole system on demand: broken links, orphan pages, naming violations." - Growth — "
/setuplets the system learn new capabilities without breaking the structure."
Then show the setup roadmap, marking what can be skipped:
Setup takes ~5 minutes: 1. Language (required) → 2. Simple or advanced mode (required, default simple) → 3. Naming convention (explained, customizable) → 4. Modules — Voice, Brand, Todos, Dev Planning (all optional — skip any, activate later with one command) → 5. Your current work → first project (optional). Skip anything optional; I'll suggest it later when it would help.
Every skippable question accepts "skip" and moves on without discussion.
C. Interview (one question at a time)
- Language. Ask which language to work in; reply in the user's language from their first answer onward. Note in one line: folder and file names always use Latin-alphabet kebab-case regardless of language (any language written in Latin letters is fine; other scripts are transliterated).
- Tier. "Keep it simple, or full control?" — simple: 2-level projects, numbering and IDs managed silently; advanced: full protocol, 3-level hierarchies,
/dev. Default simple; switchable anytime with/axiom tier. - Naming convention. Explain the default convention briefly, scaled to the chosen tier — always: folder and file names are lowercase Latin kebab-case (
market-analysis.md); every project and workstation folder carries an uppercase acronym prefix (ED-elena-design) so it is identifiable at a glance. Advanced tier additionally: sub-units and work packages / work areas carry two-digit number prefixes (01-marketing/02-seo-optimization), and those numbers form the task IDs (ED-01-02-05). Then one line on produced files, again scaled to the tier — simple: "documents I produce get a stable name with a running number, which I manage for you — no dates or version numbers in filenames, so links to them keep working"; advanced: the full pattern<acr>-<address>-<NNN>-<name>.<ext>(ed-02-002-keyword-analysis.md), the number from the work package's own counter, with version and date living inside the document. Close with one line: this convention is the system default — if the user prefers a different scheme, it can be customized later via/setup new(a setup file adapts the convention system-wide and consistently). Not a blocking question; continue unless the user objects. - Modules (multi-select, one-line pitches): Voice (drafts sound like you), Brand (colors/logo/tone applied to documents), Todos (task tracking, optional Notion board), Dev Planning (spec → plan → features; advanced tier only — selecting it from simple triggers the tier question again).
- Current work. "What are you working on right now?" — free text, feeds step E.
D. Scaffold
Create in this order (skip whatever already exists):
- Folders:
projects/,workstations/,vault/me/,vault/projects/,vault/workstations/,vault/knowledge/,vault/sources/,setup/done/,.claude/templates/; plusbrand/config/,brand/images/,brand/templates/if M2-brand. CLAUDE.md— render fromclaude-kernel-template.md: fill{{PLACEHOLDERS}}, include only the active modules' blocks and the chosen tier's blocks, strip all marker comments.axiom-config.mdfrom its template (language, tier, module flags, empty nudge log).vault/index.md,vault/log.md(first entry: setup),vault/me/profile.mdseeded from interview Q5.GETTING-STARTED.mdfrom its template..claude/templates/output-document-template.md— copyoutput-document-template.mdverbatim (no placeholders to fill; its<...>markers belong to the documents produced from it).setup/README.md— the setup area's register:Acronym: **SU**,Next setup: **001**, and one line stating the file naming rule (su-<NNN>-<name>.md, allocated by/setup newat drafting, kept when the file is archived todone/).
Then run the mini-interview for each selected module (same flows as "activate" below). Log everything to vault/log.md.
E. First win
From Q5's answer, propose concretely: bounded goal → "shall we create this as your first project?"; recurring activity → workstation. Restate the project/workstation distinction in one line so the user understands why this type was proposed. On yes, run the normal /project new project or /ws new WS flow — this shows numbering, the vault mirror, and the plan → approve → execute loop in action. On skip, point to /project and /ws.
F. Wrap-up
Summary table (language, tier, active modules) + up to three "try next" suggestions based on the interview + one line each: /axiom status shows this anytime, /axiom activate adds skipped modules, the vault/ folder can be opened as an Obsidian vault for browsing (optional), and feedback/bug reports are welcome at https://github.com/protonium-labs/axiomcore-plugin/issues.
If action is "activate"
- Parse the module:
M2-voice,M2-brand,M3,M4(accept natural names: voice, brand, todos, dev). Unknown → list valid modules. Already active → say so, stop. - Run the module's mini-interview:
- M2-voice: how the user writes (3 adjectives), formality preference, do/don't phrases, optional sample text to imitate → render
soul.mdfromsoul-template.md. - M2-brand: logo file (into
brand/images/), primary/accent colors (or offer to extract from the logo), optionaltemplate.pptx/template.xlsx(intobrand/templates/) → renderbrand/config/brand-config.md. Any item skippable. - M3: check whether a Notion connector is available. Available → offer the Kanban mirror (mode
notion) or vault-only; unavailable → modevault-only, one line that connecting Notion later upgrades it. - M4: requires advanced tier — from simple, run the tier dialog first (see "tier"). No interview; confirm the order spec → plan → feature and that this skill plans, never codes.
- M2-voice: how the user writes (3 adjectives), formality preference, do/don't phrases, optional sample text to imitate → render
- Insert the module's block into
CLAUDE.md(from the kernel template, markers stripped). - Flip the flag in
axiom-config.md, append tovault/log.md, confirm with one concrete usage example.
If action is "deactivate"
- Parse the module; M1 cannot be deactivated. Not active → say so.
- Remove the module's block from
CLAUDE.md, flip the flag. Never delete user files (soul.md,brand/,tasks.mdcontents stay untouched) — say so explicitly. - Log and confirm.
If action is "tier"
- Parse target tier. Same as current → say so.
- simple → advanced: explain what unlocks (3-level hierarchies, exposed ID protocol,
/devavailability, structural migrations via/setup). Swap the tier blocks inCLAUDE.md. Existing projects keep their depth — nothing is restructured. - advanced → simple: warn what gets hidden (not removed): 3-level creation,
/dev. Existing 3-level projects continue to work; only new creation is limited. Confirm before applying. - Update
axiom-config.md, log, confirm.
If action is "language"
- Parse the language. Update
Language:inaxiom-config.mdand the working-language line inCLAUDE.md. - Confirm in the new language. Remind in one line: existing content stays as written; structure names remain Latin kebab-case.
If action is "status"
Read axiom-config.md and report: language, tier, module table (active/inactive, M3 mode), nudge setting, last 5 nudge-log entries. One screen, no lecture. If modules are inactive, close with a one-line reminder that /axiom activate <module> turns them on.
After any action
- Append to
vault/log.md(exception:statusis read-only, not logged). - Rendered/changed
CLAUDE.mdmust be lint-clean and carry an updatedLast updateddate.
Notes
- Nudges (kernel "Recommendations" section) always route here: an accepted nudge runs
activate; a declined one is logged in the config's Nudge Log with the date (30-day cooldown). - The template repo is a convenience, not a requirement —
startscaffolds a complete workspace in an empty folder.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

