# Rules > Use when working with the 50 rules of natural language programming. Loaded when writing, reviewing, or improving any NL artifact — skills, agents, commands, rules, hooks, prompts, plugins, and the project memory file (CLAUDE.md / AGENTS.md / GEMINI.md). The definitive style guide for NL code quality. - Skill: `tomevault-io/rules` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/rules` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/rules/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/rules --- # The Rules of Natural Language Programming > These rules govern how to write NL artifacts that Claude Code and other LLMs consume. They are enforced by `/nlpm:score` (penalty-based) and referenced by `/nlpm:fix` (auto-repair). When writing any NL artifact, follow these rules. --- ## Universal (all artifacts) **R01. No vague quantifiers without criteria.** "appropriate", "relevant", "as needed", "sufficient", "adequate", "reasonable", "properly", "correctly", "some", "several", "various" are meaningless without specifics. Replace with measurable criteria. Penalty: -2 each, cap -20. Bad: "Use appropriate error handling." Good: "Return `Result` from all API handlers. Map errors to HTTP status codes via the `From for StatusCode` impl." > Real-world example: [AgriciDaniel-claude-ads](../../../auditor/exemplars/AgriciDaniel-claude-ads.md), [ChromeDevTools-chrome-devtools-mcp](../../../auditor/exemplars/ChromeDevTools-chrome-devtools-mcp.md), [Xquik-dev-x-twitter-scraper](../../../auditor/exemplars/Xquik-dev-x-twitter-scraper.md), [blader-humanizer](../../../auditor/exemplars/blader-humanizer.md), [coreyhaines31-marketingskills](../../../auditor/exemplars/coreyhaines31-marketingskills.md), [google-labs-code-stitch-skills](../../../auditor/exemplars/google-labs-code-stitch-skills.md), [kazukinagata-shinkoku](../../../auditor/exemplars/kazukinagata-shinkoku.md), [krodak-clickup-cli](../../../auditor/exemplars/krodak-clickup-cli.md), [nexu-io-open-design](../../../auditor/exemplars/nexu-io-open-design.md), [slavingia-skills](../../../auditor/exemplars/slavingia-skills.md) **R02. Every line must earn its tokens.** Context window is finite. If a line doesn't change Claude's behavior, delete it. > Real-world example: [Kamalnrf-claude-plugins](../../../auditor/exemplars/Kamalnrf-claude-plugins.md), [forrestchang-andrej-karpathy-skills](../../../auditor/exemplars/forrestchang-andrej-karpathy-skills.md), [krodak-clickup-cli](../../../auditor/exemplars/krodak-clickup-cli.md), [multica-ai-andrej-karpathy-skills](../../../auditor/exemplars/multica-ai-andrej-karpathy-skills.md) **R03. Positive framing over prohibitions.** "Use X" not "Don't use Y." The Pink Elephant effect: Claude fixates on prohibited things and sometimes does them anyway. > Real-world example: [karpathy-autoresearch](../../../auditor/exemplars/karpathy-autoresearch.md) --- ## Skills (SKILL.md) **R04. Description is a trigger, not a summary.** 3+ specific action phrases matching real user queries. "Use when debugging React re-renders, fixing hook dependency arrays, optimizing with useMemo" — not "Helpful React skill." > Real-world example: [2389-research-review-squad](../../../auditor/exemplars/2389-research-review-squad.md), [2389-research-simmer](../../../auditor/exemplars/2389-research-simmer.md), [AgriciDaniel-claude-ads](../../../auditor/exemplars/AgriciDaniel-claude-ads.md), [AgriciDaniel-claude-seo](../../../auditor/exemplars/AgriciDaniel-claude-seo.md), [BayramAnnakov-claude-reflect](../../../auditor/exemplars/BayramAnnakov-claude-reflect.md), [ChromeDevTools-chrome-devtools-mcp](../../../auditor/exemplars/ChromeDevTools-chrome-devtools-mcp.md), [CloudAI-X-claude-workflow-v2](../../../auditor/exemplars/CloudAI-X-claude-workflow-v2.md), [Dammyjay93-interface-design](../../../auditor/exemplars/Dammyjay93-interface-design.md), [Jeffallan-claude-skills](../../../auditor/exemplars/Jeffallan-claude-skills.md), [JimLiu-baoyu-skills](../../../auditor/exemplars/JimLiu-baoyu-skills.md), [JuliusBrussee-cavekit](../../../auditor/exemplars/JuliusBrussee-cavekit.md), [JuliusBrussee-caveman](../../../auditor/exemplars/JuliusBrussee-caveman.md), [Kamalnrf-claude-plugins](../../../auditor/exemplars/Kamalnrf-claude-plugins.md), [Master-cai-Research-Paper-Writing-Skills](../../../auditor/exemplars/Master-cai-Research-Paper-Writing-Skills.md), [MemPalace-mempalace](../../../auditor/exemplars/MemPalace-mempalace.md), [OthmanAdi-planning-with-files](../../../auditor/exemplars/OthmanAdi-planning-with-files.md), [RKiding-Awesome-finance-skills](../../../auditor/exemplars/RKiding-Awesome-finance-skills.md), [ReflexioAI-claude-smart](../../../auditor/exemplars/ReflexioAI-claude-smart.md), [SukinShetty-Nemp-memory](../../../auditor/exemplars/SukinShetty-Nemp-memory.md), [The-Vibe-Company-companion](../../../auditor/exemplars/The-Vibe-Company-companion.md), [Xquik-dev-x-twitter-scraper](../../../auditor/exemplars/Xquik-dev-x-twitter-scraper.md), [Yuan1z0825-nature-skills](../../../auditor/exemplars/Yuan1z0825-nature-skills.md), [addyosmani-web-quality-skills](../../../auditor/exemplars/addyosmani-web-quality-skills.md), [agenticnotetaking-arscontexta](../../../auditor/exemplars/agenticnotetaking-arscontexta.md), [alexgreensh-token-optimizer](../../../auditor/exemplars/alexgreensh-token-optimizer.md), [alizarion-openclaw-claude-code-plugin](../../../auditor/exemplars/alizarion-openclaw-claude-code-plugin.md), [antfu-skills](../../../auditor/exemplars/antfu-skills.md), [astral-sh-claude-code-plugins](../../../auditor/exemplars/astral-sh-claude-code-plugins.md), [axtonliu-axton-obsidian-visual-skills](../../../auditor/exemplars/axtonliu-axton-obsidian-visual-skills.md), [backnotprop-plannotator](../../../auditor/exemplars/backnotprop-plannotator.md), [blader-humanizer](../../../auditor/exemplars/blader-humanizer.md), [coreyhaines31-marketingskills](../../../auditor/exemplars/coreyhaines31-marketingskills.md), [czlonkowski-n8n-skills](../../../auditor/exemplars/czlonkowski-n8n-skills.md), [data-goblin-power-bi-agentic-development](../../../auditor/exemplars/data-goblin-power-bi-agentic-development.md), [dontbesilent2025-dbskill](../../../auditor/exemplars/dontbesilent2025-dbskill.md), [evo-hq-evo](../../../auditor/exemplars/evo-hq-evo.md), [expo-skills](../../../auditor/exemplars/expo-skills.md), [firecrawl-firecrawl-claude-plugin](../../../auditor/exemplars/firecrawl-firecrawl-claude-plugin.md), [fivetaku-fablize](../../../auditor/exemplars/fivetaku-fablize.md), [forrestchang-andrej-karpathy-skills](../../../auditor/exemplars/forrestchang-andrej-karpathy-skills.md), [google-labs-code-stitch-skills](../../../auditor/exemplars/google-labs-code-stitch-skills.md), [google-skills](../../../auditor/exemplars/google-skills.md), [itsmostafa-aws-agent-skills](../../../auditor/exemplars/itsmostafa-aws-agent-skills.md), [jnMetaCode-superpowers-zh](../../../auditor/exemplars/jnMetaCode-superpowers-zh.md), [kazukinagata-shinkoku](../../../auditor/exemplars/kazukinagata-shinkoku.md), [kepano-obsidian-skills](../../../auditor/exemplars/kepano-obsidian-skills.md), [krodak-clickup-cli](../../../auditor/exemplars/krodak-clickup-cli.md), [lackeyjb-playwright-skill](../../../auditor/exemplars/lackeyjb-playwright-skill.md), [m1heng-claude-plugin-weixin](../../../auditor/exemplars/m1heng-claude-plugin-weixin.md), [mattpocock-skills](../../../auditor/exemplars/mattpocock-skills.md), [mem0ai-mem0](../../../auditor/exemplars/mem0ai-mem0.md), [multica-ai-andrej-karpathy-skills](../../../auditor/exemplars/multica-ai-andrej-karpathy-skills.md), [muratcankoylan-ralph-wiggum-marketer](../../../auditor/exemplars/muratcankoylan-ralph-wiggum-marketer.md), [nagisanzenin-claude-code-production-grade-plugin](../../../auditor/exemplars/nagisanzenin-claude-code-production-grade-plugin.md), [nexu-io-open-design](../../../auditor/exemplars/nexu-io-open-design.md), [nicknisi-claude-plugins](../../../auditor/exemplars/nicknisi-claude-plugins.md), [numman-ali-n-skills](../../../auditor/exemplars/numman-ali-n-skills.md), [ooiyeefei-ccc](../../../auditor/exemplars/ooiyeefei-ccc.md), [openai-codex-plugin-cc](../../../auditor/exemplars/openai-codex-plugin-cc.md), [pe-menezes-fin-claude-plugin](../../../auditor/exemplars/pe-menezes-fin-claude-plugin.md), [shinpr-claude-code-workflows](../../../auditor/exemplars/shinpr-claude-code-workflows.md), [slavingia-skills](../../../auditor/exemplars/slavingia-skills.md), [softaworks-agent-toolkit](../../../auditor/exemplars/softaworks-agent-toolkit.md), [taishi-i-awesome-japanese-nlp-resources](../../../auditor/exemplars/taishi-i-awesome-japanese-nlp-resources.md), [tanweai-pua](../../../auditor/exemplars/tanweai-pua.md), [team-attention-plugins-for-claude-natives](../../../auditor/exemplars/team-attention-plugins-for-claude-natives.md), [tech-leads-club-agent-skills](../../../auditor/exemplars/tech-leads-club-agent-skills.md), [teng-lin-notebooklm-py](../../../auditor/exemplars/teng-lin-notebooklm-py.md), [timescale-pg-aiguide](../../../auditor/exemplars/timescale-pg-aiguide.md), [tirth8205-code-review-graph](../../../auditor/exemplars/tirth8205-code-review-graph.md), [viticci-shortcuts-playground-plugin](../../../auditor/exemplars/viticci-shortcuts-playground-plugin.md), [vladikk-modularity](../../../auditor/exemplars/vladikk-modularity.md), [xiaolai-grill-for-claude](../../../auditor/exemplars/xiaolai-grill-for-claude.md), [ykdojo-claude-code-tips](../../../auditor/exemplars/ykdojo-claude-code-tips.md) **R05. Under 500 lines.** Over 500 = context bloat. Split into scoped sub-skills with cross-references. > Real-world example: [2389-research-review-squad](../../../auditor/exemplars/2389-research-review-squad.md), [AgriciDaniel-claude-seo](../../../auditor/exemplars/AgriciDaniel-claude-seo.md), [BayramAnnakov-claude-reflect](../../../auditor/exemplars/BayramAnnakov-claude-reflect.md), [ChromeDevTools-chrome-devtools-mcp](../../../auditor/exemplars/ChromeDevTools-chrome-devtools-mcp.md), [CloudAI-X-claude-workflow-v2](../../../auditor/exemplars/CloudAI-X-claude-workflow-v2.md), [Dammyjay93-interface-design](../../../auditor/exemplars/Dammyjay93-interface-design.md), [Jeffallan-claude-skills](../../../auditor/exemplars/Jeffallan-claude-skills.md), [JimLiu-baoyu-skills](../../../auditor/exemplars/JimLiu-baoyu-skills.md), [MemPalace-mempalace](../../../auditor/exemplars/MemPalace-mempalace.md), [OthmanAdi-planning-with-files](../../../auditor/exemplars/OthmanAdi-planning-with-files.md), [RKiding-Awesome-finance-skills](../../../auditor/exemplars/RKiding-Awesome-finance-skills.md), [Xquik-dev-x-twitter-scraper](../../../auditor/exemplars/Xquik-dev-x-twitter-scraper.md), [Yuan1z0825-nature-skills](../../../auditor/exemplars/Yuan1z0825-nature-skills.md), [addyosmani-web-quality-skills](../../../auditor/exemplars/addyosmani-web-quality-skills.md), [alexgreensh-token-optimizer](../../../auditor/exemplars/alexgreensh-token-optimizer.md), [alizarion-openclaw-claude-code-plugin](../../../auditor/exemplars/alizarion-openclaw-claude-code-plugin.md), [antfu-skills](../../../auditor/exemplars/antfu-skills.md), [astral-sh-claude-code-plugins](../../../auditor/exemplars/astral-sh-claude-code-plugins.md), [axtonliu-axton-obsidian-visual-skills](../../../auditor/exemplars/axtonliu-axton-obsidian-visual-skills.md), [data-goblin-power-bi-agentic-development](../../../auditor/exemplars/data-goblin-power-bi-agentic-development.md), [dontbesilent2025-dbskill](../../../auditor/exemplars/dontbesilent2025-dbskill.md), [evo-hq-evo](../../../auditor/exemplars/evo-hq-evo.md), [expo-skills](../../../auditor/exemplars/expo-skills.md), [firecrawl-firecrawl-claude-plugin](../../../auditor/exemplars/firecrawl-firecrawl-claude-plugin.md), [fivetaku-fablize](../../../auditor/exemplars/fivetaku-fablize.md), [forrestchang-andrej-karpathy-skills](../../../auditor/exemplars/forrestchang-andrej-karpathy-skills.md), [google-labs-code-stitch-skills](../../../auditor/exemplars/google-labs-code-stitch-skills.md), [google-skills](../../../auditor/exemplars/google-skills.md), [htdt-godogen](../../../auditor/exemplars/htdt-godogen.md), [itsmostafa-aws-agent-skills](../../../auditor/exemplars/itsmostafa-aws-agent-skills.md), [kepano-obsidian-skills](../../../auditor/exemplars/kepano-obsidian-skills.md), [krodak-clickup-cli](../../../auditor/exemplars/krodak-clickup-cli.md), [lackeyjb-playwright-skill](../../../auditor/exemplars/lackeyjb-playwright-skill.md), [m1heng-claude-plugin-weixin](../../../auditor/exemplars/m1heng-claude-plugin-weixin.md), [mattpocock-skills](../../../auditor/exemplars/mattpocock-skills.md), [mem0ai-mem0](../../../auditor/exemplars/mem0ai-mem0.md), [multica-ai-andrej-karpathy-skills](../../../auditor/exemplars/multica-ai-andrej-karpathy-skills.md), [muratcankoylan-ralph-wiggum-marketer](../../../auditor/exemplars/muratcankoylan-ralph-wiggum-marketer.md), [nagisanzenin-claude-code-production-grade-plugin](../../../auditor/exemplars/nagisanzenin-claude-code-production-grade-plugin.md), [nexu-io-open-design](../../../auditor/exemplars/nexu-io-open-design.md), [nicknisi-claude-plugins](../../../auditor/exemplars/nicknisi-claude-plugins.md), [numman-ali-n-skills](../../../auditor/exemplars/numman-ali-n-skills.md), [slavingia-skills](../../../auditor/exemplars/slavingia-skills.md), [softaworks-agent-toolkit](../../../auditor/exemplars/softaworks-agent-toolkit.md), [taishi-i-awesome-japanese-nlp-resources](../../../auditor/exemplars/taishi-i-awesome-japanese-nlp-resources.md), [tech-leads-club-agent-skills](../../../auditor/exemplars/tech-leads-club-agent-skills.md), [tirth8205-code-review-graph](../../../auditor/exemplars/tirth8205-code-review-graph.md), [viticci-shortcuts-playground-plugin](../../../auditor/exemplars/viticci-shortcuts-playground-plugin.md), [vladikk-modularity](../../../auditor/exemplars/vladikk-modularity.md), [ykdojo-claude-code-tips](../../../auditor/exemplars/ykdojo-claude-code-tips.md) **R06. Code examples must be runnable.** Not pseudocode. Show the problem, then the solution, in real syntax. > Real-world example: [2389-research-simmer](../../../auditor/exemplars/2389-research-simmer.md), [AgriciDaniel-claude-ads](../../../auditor/exemplars/AgriciDaniel-claude-ads.md), [BayramAnnakov-claude-reflect](../../../auditor/exemplars/BayramAnnakov-claude-reflect.md), [ChromeDevTools-chrome-devtools-mcp](../../../auditor/exemplars/ChromeDevTools-chrome-devtools-mcp.md), [CloudAI-X-claude-workflow-v2](../../../auditor/exemplars/CloudAI-X-claude-workflow-v2.md), [CoderGamester-mcp-unity](../../../auditor/exemplars/CoderGamester-mcp-unity.md), [Jeffallan-claude-skills](../../../auditor/exemplars/Jeffallan-claude-skills.md), [JimLiu-baoyu-skills](../../../auditor/exemplars/JimLiu-baoyu-skills.md), [JuliusBrussee-cavekit](../../../auditor/exemplars/JuliusBrussee-cavekit.md), [JuliusBrussee-caveman](../../../auditor/exemplars/JuliusBrussee-caveman.md), [Kamalnrf-claude-plugins](../../../auditor/exemplars/Kamalnrf-claude-plugins.md), [Master-cai-Research-Paper-Writing-Skills](../../../auditor/exemplars/Master-cai-Research-Paper-Writing-Skills.md), [MemPalace-mempalace](../../../auditor/exemplars/MemPalace-mempalace.md), [RKiding-Awesome-finance-skills](../../../auditor/exemplars/RKiding-Awesome-finance-skills.md), [ReflexioAI-claude-smart](../../../auditor/exemplars/ReflexioAI-claude-smart.md), [Xquik-dev-x-twitter-scraper](../../../auditor/exemplars/Xquik-dev-x-twitter-scraper.md), [YishenTu-claudian](../../../auditor/exemplars/YishenTu-claudian.md), [addyosmani-web-quality-skills](../../../auditor/exemplars/addyosmani-web-quality-skills.md), [agenticnotetaking-arscontexta](../../../auditor/exemplars/agenticnotetaking-arscontexta.md), [alexgreensh-token-optimizer](../../../auditor/exemplars/alexgreensh-token-optimizer.md), [alizarion-openclaw-claude-code-plugin](../../../auditor/exemplars/alizarion-openclaw-claude-code-plugin.md), [antfu-skills](../../../auditor/exemplars/antfu-skills.md), [astral-sh-claude-code-plugins](../../../auditor/exemplars/astral-sh-claude-code-plugins.md), [axtonliu-axton-obsidian-visual-skills](../../../auditor/exemplars/axtonliu-axton-obsidian-visual-skills.md), [backnotprop-plannotator](../../../auditor/exemplars/backnotprop-plannotator.md), [blader-humanizer](../../../auditor/exemplars/blader-humanizer.md), [coreyhaines31-marketingskills](../../../auditor/exemplars/coreyhaines31-marketingskills.md), [czlonkowski-n8n-skills](../../../auditor/exemplars/czlonkowski-n8n-skills.md), [data-goblin-power-bi-agentic-development](../../../auditor/exemplars/data-goblin-power-bi-agentic-development.md), [evo-hq-evo](../../../auditor/exemplars/evo-hq-evo.md), [expo-skills](../../../auditor/exemplars/expo-skills.md), [firecrawl-firecrawl-claude-plugin](../../../auditor/exemplars/firecrawl-firecrawl-claude-plugin.md), [fivetaku-fablize](../../../auditor/exemplars/fivetaku-fablize.md), [google-labs-code-stitch-skills](../../../auditor/exemplars/google-labs-code-stitch-skills.md), [google-skills](../../../auditor/exemplars/google-skills.md), [itsmostafa-aws-agent-skills](../../../auditor/exemplars/itsmostafa-aws-agent-skills.md), [jnMetaCode-superpowers-zh](../../../auditor/exemplars/jnMetaCode-superpowers-zh.md), [kazukinagata-shinkoku](../../../auditor/exemplars/kazukinagata-shinkoku.md), [kepano-obsidian-skills](../../../auditor/exemplars/kepano-obsidian-skills.md), [krodak-clickup-cli](../../../auditor/exemplars/krodak-clickup-cli.md), [lackeyjb-playwright-skill](../../../auditor/exemplars/lackeyjb-playwright-skill.md), [m1heng-claude-plugin-weixin](../../../auditor/exemplars/m1heng-claude-plugin-weixin.md), [mattpocock-skills](../../../auditor/exemplars/mattpocock-skills.md), [multica-ai-andrej-karpathy-skills](../../../auditor/exemplars/multica-ai-andrej-karpathy-skills.md), [muratcankoylan-ralph-wiggum-marketer](../../../auditor/exemplars/muratcankoylan-ralph-wiggum-marketer.md), [nexu-io-open-design](../../../auditor/exemplars/nexu-io-open-design.md), [numman-ali-n-skills](../../../auditor/exemplars/numman-ali-n-skills.md), [shinpr-claude-code-workflows](../../../auditor/exemplars/shinpr-claude-code-workflows.md), [softaworks-agent-toolkit](../../../auditor/exemplars/softaworks-agent-toolkit.md), [taishi-i-awesome-japanese-nlp-resources](../../../auditor/exemplars/taishi-i-awesome-japanese-nlp-resources.md), [tanweai-pua](../../../auditor/exemplars/tanweai-pua.md), [tech-leads-club-agent-skills](../../../auditor/exemplars/tech-leads-club-agent-skills.md), [teng-lin-notebooklm-py](../../../auditor/exemplars/teng-lin-notebooklm-py.md), [timescale-pg-aiguide](../../../auditor/exemplars/timescale-pg-aiguide.md), [tirth8205-code-review-graph](../../../auditor/exemplars/tirth8205-code-review-graph.md), [xiaolai-grill-for-claude](../../../auditor/exemplars/xiaolai-grill-for-claude.md), [ykdojo-claude-code-tips](../../../auditor/exemplars/ykdojo-claude-code-tips.md) **R07. Scope note when related skills exist.** "Covers X. For Y, see [[other-skill]]." Without this, Claude doesn't know which skill to pick. > Real-world example: [2389-research-review-squad](../../../auditor/exemplars/2389-research-review-squad.md), [2389-research-simmer](../../../auditor/exemplars/2389-research-simmer.md), [AgriciDaniel-claude-ads](../../../auditor/exemplars/AgriciDaniel-claude-ads.md), [AgriciDaniel-claude-seo](../../../auditor/exemplars/AgriciDaniel-claude-seo.md), [ChromeDevTools-chrome-devtools-mcp](../../../auditor/exemplars/ChromeDevTools-chrome-devtools-mcp.md), [CloudAI-X-claude-workflow-v2](../../../auditor/exemplars/CloudAI-X-claude-workflow-v2.md), [Dammyjay93-interface-design](../../../auditor/exemplars/Dammyjay93-interface-design.md), [Jeffallan-claude-skills](../../../auditor/exemplars/Jeffallan-claude-skills.md), [JuliusBrussee-cavekit](../../../auditor/exemplars/JuliusBrussee-cavekit.md), [Master-cai-Research-Paper-Writing-Skills](../../../auditor/exemplars/Master-cai-Research-Paper-Writing-Skills.md), [OthmanAdi-planning-with-files](../../../auditor/exemplars/OthmanAdi-planning-with-files.md), [ReflexioAI-claude-smart](../../../auditor/exemplars/ReflexioAI-claude-smart.md), [The-Vibe-Company-companion](../../../auditor/exemplars/The-Vibe-Company-companion.md), [Xquik-dev-x-twitter-scraper](../../../auditor/exemplars/Xquik-dev-x-twitter-scraper.md), [Yuan1z0825-nature-skills](../../../auditor/exemplars/Yuan1z0825-nature-skills.md), [addyosmani-web-quality-skills](../../../auditor/exemplars/addyosmani-web-quality-skills.md), [alexgreensh-token-optimizer](../../../auditor/exemplars/alexgreensh-token-optimizer.md), [alizarion-openclaw-claude-code-plugin](../../../auditor/exemplars/alizarion-openclaw-claude-code-plugin.md), [axtonliu-axton-obsidian-visual-skills](../../../auditor/exemplars/axtonliu-axton-obsidian-visual-skills.md), [backnotprop-plannotator](../../../auditor/exemplars/backnotprop-plannotator.md), [coreyhaines31-marketingskills](../../../auditor/exemplars/coreyhaines31-marketingskills.md), [czlonkowski-n8n-skills](../../../auditor/exemplars/czlonkowski-n8n-skills.md), [data-goblin-power-bi-agentic-development](../../../auditor/exemplars/data-goblin-power-bi-agentic-development.md), [dontbesilent2025-dbskill](../../../auditor/exemplars/dontbesilent2025-dbskill.md), [evo-hq-evo](../../../auditor/exemplars/evo-hq-evo.md), [expo-skills](../../../auditor/exemplars/expo-skills.md), [firecrawl-firecrawl-claude-plugin](../../../auditor/exemplars/firecrawl-firecrawl-claude-plugin.md), [google-labs-code-stitch-skills](../../../auditor/exemplars/google-labs-code-stitch-skills.md), [htdt-godogen](../../../auditor/exemplars/htdt-godogen.md), [jnMetaCode-superpowers-zh](../../../auditor/exemplars/jnMetaCode-superpowers-zh.md), [kazukinagata-shinkoku](../../../auditor/exemplars/kazukinagata-shinkoku.md), [kepano-obsidian-skills](../../../auditor/exemplars/kepano-obsidian-skills.md), [lackeyjb-playwright-skill](../../../auditor/exemplars/lackeyjb-playwright-skill.md), [mattpocock-skills](../../../auditor/exemplars/mattpocock-skills.md), [mem0ai-mem0](../../../auditor/exemplars/mem0ai-mem0.md), [muratcankoylan-ralph-wiggum-marketer](../../../auditor/exemplars/muratcankoylan-ralph-wiggum-marketer.md), [nagisanzenin-claude-code-production-grade-plugin](../../../auditor/exemplars/nagisanzenin-claude-code-production-grade-plugin.md), [numman-ali-n-skills](../../../auditor/exemplars/numman-ali-n-skills.md), [ooiyeefei-ccc](../../../auditor/exemplars/ooiyeefei-ccc.md), [openai-codex-plugin-cc](../../../auditor/exemplars/openai-codex-plugin-cc.md), [pe-menezes-fin-claude-plugin](../../../auditor/exemplars/pe-menezes-fin-claude-plugin.md), [shinpr-claude-code-workflows](../../../auditor/exemplars/shinpr-claude-code-workflows.md), [slavingia-skills](../../../auditor/exemplars/slavingia-skills.md), [softaworks-agent-toolkit](../../../auditor/exemplars/softaworks-agent-toolkit.md), [taishi-i-awesome-japanese-nlp-resources](../../../auditor/exemplars/taishi-i-awesome-japanese-nlp-resources.md), [team-attention-plugins-for-claude-natives](../../../auditor/exemplars/team-attention-plugins-for-claude-natives.md), [tech-leads-club-agent-skills](../../../auditor/exemplars/tech-leads-club-agent-skills.md), [timescale-pg-aiguide](../../../auditor/exemplars/timescale-pg-aiguide.md), [viticci-shortcuts-playground-plugin](../../../auditor/exemplars/viticci-shortcuts-playground-plugin.md), [vladikk-modularity](../../../auditor/exemplars/vladikk-modularity.md) **R08. Patterns over theory.** Teach what to do in specific situations, not abstract concepts. > Real-world example: [2389-research-review-squad](../../../auditor/exemplars/2389-research-review-squad.md), [2389-research-simmer](../../../auditor/exemplars/2389-research-simmer.md), [AgriciDaniel-claude-ads](../../../auditor/exemplars/AgriciDaniel-claude-ads.md), [AgriciDaniel-claude-seo](../../../auditor/exemplars/AgriciDaniel-claude-seo.md), [BayramAnnakov-claude-reflect](../../../auditor/exemplars/BayramAnnakov-claude-reflect.md), [ChromeDevTools-chrome-devtools-mcp](../../../auditor/exemplars/ChromeDevTools-chrome-devtools-mcp.md), [CloudAI-X-claude-workflow-v2](../../../auditor/exemplars/CloudAI-X-claude-workflow-v2.md), [Dammyjay93-interface-design](../../../auditor/exemplars/Dammyjay93-interface-design.md), [Jeffallan-claude-skills](../../../auditor/exemplars/Jeffallan-claude-skills.md), [JimLiu-baoyu-skills](../../../auditor/exemplars/JimLiu-baoyu-skills.md), [JuliusBrussee-cavekit](../../../auditor/exemplars/JuliusBrussee-cavekit.md), [JuliusBrussee-caveman](../../../auditor/exemplars/JuliusBrussee-caveman.md), [Kamalnrf-claude-plugins](../../../auditor/exemplars/Kamalnrf-claude-plugins.md), [Master-cai-Research-Paper-Writing-Skills](../../../auditor/exemplars/Master-cai-Research-Paper-Writing-Skills.md), [MemPalace-mempalace](../../../auditor/exemplars/MemPalace-mempalace.md), [OthmanAdi-planning-with-files](../../../auditor/exemplars/OthmanAdi-planning-with-files.md), [RKiding-Awesome-finance-skills](../../../auditor/exemplars/RKiding-Awesome-finance-skills.md), [ReflexioAI-claude-smart](../../../auditor/exemplars/ReflexioAI-claude-smart.md), [SukinShetty-Nemp-memory](../../../auditor/exemplars/SukinShetty-Nemp-memory.md), [The-Vibe-Company-companion](../../../auditor/exemplars/The-Vibe-Company-companion.md), [Xquik-dev-x-twitter-scraper](../../../auditor/exemplars/Xquik-dev-x-twitter-scraper.md), [YishenTu-claudian](../../../auditor/exemplars/YishenTu-claudian.md), [Yuan1z0825-nature-skills](../../../auditor/exemplars/Yuan1z0825-nature-skills.md), [addyosmani-web-quality-skills](../../../auditor/exemplars/addyosmani-web-quality-skills.md), [agenticnotetaking-arscontexta](../../../auditor/exemplars/agenticnotetaking-arscontexta.md), [alexgreensh-token-optimizer](../../../auditor/exemplars/alexgreensh-token-optimizer.md), [alizarion-openclaw-claude-code-plugin](../../../auditor/exemplars/alizarion-openclaw-claude-code-plugin.md), [antfu-skills](../../../auditor/exemplars/antfu-skills.md), [astral-sh-claude-code-plugins](../../../auditor/exemplars/astral-sh-claude-code-plugins.md), [axtonliu-axton-obsidian-visual-skills](../../../auditor/exemplars/axtonliu-axton-obsidian-visual-skills.md), [backnotprop-plannotator](../../../auditor/exemplars/backnotprop-plannotator.md), [blader-humanizer](../../../auditor/exemplars/blader-humanizer.md), [coreyhaines31-marketingskills](../../../auditor/exemplars/coreyhaines31-marketingskills.md), [czlonkowski-n8n-skills](../../../auditor/exemplars/czlonkowski-n8n-skills.md), [data-goblin-power-bi-agentic-development](../../../auditor/exemplars/data-goblin-power-bi-agentic-development.md), [dontbesilent2025-dbskill](../../../auditor/exemplars/dontbesilent2025-dbskill.md), [evo-hq-evo](../../../auditor/exemplars/evo-hq-evo.md), [expo-skills](../../../auditor/exemplars/expo-skills.md), [firecrawl-firecrawl-claude-plugin](../../../auditor/exemplars/firecrawl-firecrawl-claude-plugin.md), [fivetaku-fablize](../../../auditor/exemplars/fivetaku-fablize.md), [forrestchang-andrej-karpathy-skills](../../../auditor/exemplars/forrestchang-andrej-karpathy-skills.md), [google-labs-code-stitch-skills](../../../auditor/exemplars/google-labs-code-stitch-skills.md), [google-skills](../../../auditor/exemplars/google-skills.md), [htdt-godogen](../../../auditor/exemplars/htdt-godogen.md), [itsmostafa-aws-agent-skills](../../../auditor/exemplars/itsmostafa-aws-agent-skills.md), [jarrodwatts-claude-hud](../../../auditor/exemplars/jarrodwatts-claude-hud.md), [jnMetaCode-superpowers-zh](../../../auditor/exemplars/jnMetaCode-superpowers-zh.md), [kazukinagata-shinkoku](../../../auditor/exemplars/kazukinagata-shinkoku.md), [kepano-obsidian-skills](../../../auditor/exemplars/kepano-obsidian-skills.md), [krodak-clickup-cli](../../../auditor/exemplars/krodak-clickup-cli.md), [lackeyjb-playwright-skill](../../../auditor/exemplars/lackeyjb-playwright-skill.md), [m1heng-claude-plugin-weixin](../../../auditor/exemplars/m1heng-claude-plugin-weixin.md), [mattpocock-skills](../../../auditor/exemplars/mattpocock-skills.md), [mem0ai-mem0](../../../auditor/exemplars/mem0ai-mem0.md), [multica-ai-andrej-karpathy-skills](../../../auditor/exemplars/multica-ai-andrej-karpathy-skills.md), [muratcankoylan-ralph-wiggum-marketer](../../../auditor/exemplars/muratcankoylan-ralph-wiggum-marketer.md), [nagisanzenin-claude-code-production-grade-plugin](../../../auditor/exemplars/nagisanzenin-claude-code-production-grade-plugin.md), [nexu-io-open-design](../../../auditor/exemplars/nexu-io-open-design.md), [nicknisi-claude-plugins](../../../auditor/exemplars/nicknisi-claude-plugins.md), [numman-ali-n-skills](../../../auditor/exemplars/numman-ali-n-skills.md), [ooiyeefei-ccc](../../../auditor/exemplars/ooiyeefei-ccc.md), [openai-codex-plugin-cc](../../../auditor/exemplars/openai-codex-plugin-cc.md), [pe-menezes-fin-claude-plugin](../../../auditor/exemplars/pe-menezes-fin-claude-plugin.md), [shinpr-claude-code-workflows](../../../auditor/exemplars/shinpr-claude-code-workflows.md), [slavingia-skills](../../../auditor/exemplars/slavingia-skills.md), [softaworks-agent-toolkit](../../../auditor/exemplars/softaworks-agent-toolkit.md), [taishi-i-awesome-japanese-nlp-resources](../../../auditor/exemplars/taishi-i-awesome-japanese-nlp-resources.md), [tanweai-pua](../../../auditor/exemplars/tanweai-pua.md), [team-attention-plugins-for-claude-natives](../../../auditor/exemplars/team-attention-plugins-for-claude-natives.md), [tech-leads-club-agent-skills](../../../auditor/exemplars/tech-leads-club-agent-skills.md), [teng-lin-notebooklm-py](../../../auditor/exemplars/teng-lin-notebooklm-py.md), [timescale-pg-aiguide](../../../auditor/exemplars/timescale-pg-aiguide.md), [tirth8205-code-review-graph](../../../auditor/exemplars/tirth8205-code-review-graph.md), [viticci-shortcuts-playground-plugin](../../../auditor/exemplars/viticci-shortcuts-playground-plugin.md), [vladikk-modularity](../../../auditor/exemplars/vladikk-modularity.md), [xiaolai-codex-toolkit-for-claude](../../../auditor/exemplars/xiaolai-codex-toolkit-for-claude.md), [ykdojo-claude-code-tips](../../../auditor/exemplars/ykdojo-claude-code-tips.md) --- ## Agents **R09. `` blocks are mandatory.** Minimum 2. Each: Context (what user is doing) + user message + assistant response. Without them, triggering is unreliable. Bad: `\nContext: User needs help\nuser: "help me"\nassistant: "I'll help."\n` Good: `\nContext: Developer refactoring auth module before PR\nuser: "Check if the auth changes have any security issues before I merge"\nassistant: "I'll dispatch the security-reviewer to audit the auth changes for vulnerabilities."\n` > Real-world example: [data-goblin-power-bi-agentic-development](../../../auditor/exemplars/data-goblin-power-bi-agentic-development.md), [nicknisi-claude-plugins](../../../auditor/exemplars/nicknisi-claude-plugins.md), [ooiyeefei-ccc](../../../auditor/exemplars/ooiyeefei-ccc.md), [xiaolai-codex-toolkit-for-claude](../../../auditor/exemplars/xiaolai-codex-toolkit-for-claude.md), [xiaolai-grill-for-claude](../../../auditor/exemplars/xiaolai-grill-for-claude.md) **R10. Model must match task complexity.** haiku = mechanical (parsing, counting). sonnet = reasoning (analysis, review). opus = complex judgment (orchestration). Wrong tier wastes money or produces weak results. > Real-world example: [AgriciDaniel-claude-ads](../../../auditor/exemplars/AgriciDaniel-claude-ads.md), [JuliusBrussee-caveman](../../../auditor/exemplars/JuliusBrussee-caveman.md), [leowux-pony](../../../auditor/exemplars/leowux-pony.md), [xiaolai-grill-for-claude](../../../auditor/exemplars/xiaolai-grill-for-claude.md) **R11. Tools follow least-privilege.** Only tools the body references. Write/Edit on a read-only agent is a security smell. > Real-world example: [AgriciDaniel-claude-ads](../../../auditor/exemplars/AgriciDaniel-claude-ads.md), [JuliusBrussee-caveman](../../../auditor/exemplars/JuliusBrussee-caveman.md), [leowux-pony](../../../auditor/exemplars/leowux-pony.md), [pe-menezes-fin-claude-plugin](../../../auditor/exemplars/pe-menezes-fin-claude-plugin.md), [tanweai-pua](../../../auditor/exemplars/tanweai-pua.md), [xiaolai-codex-toolkit-for-claude](../../../auditor/exemplars/xiaolai-codex-toolkit-for-claude.md), [xiaolai-grill-for-claude](../../../auditor/exemplars/xiaolai-grill-for-claude.md) **R12. Output format defined in body.** Every agent must specify its response structure. Without it, output varies between invocations. > Real-world example: [AgriciDaniel-claude-seo](../../../auditor/exemplars/AgriciDaniel-claude-seo.md), [CloudAI-X-claude-workflow-v2](../../../auditor/exemplars/CloudAI-X-claude-workflow-v2.md), [JuliusBrussee-caveman](../../../auditor/exemplars/JuliusBrussee-caveman.md), [leowux-pony](../../../auditor/exemplars/leowux-pony.md), [nicknisi-claude-plugins](../../../auditor/exemplars/nicknisi-claude-plugins.md), [ooiyeefei-ccc](../../../auditor/exemplars/ooiyeefei-ccc.md), [pe-menezes-fin-claude-plugin](../../../auditor/exemplars/pe-menezes-fin-claude-plugin.md), [shinpr-claude-code-workflows](../../../auditor/exemplars/shinpr-claude-code-workflows.md), [team-attention-plugins-for-claude-natives](../../../auditor/exemplars/team-attention-plugins-for-claude-natives.md), [xiaolai-codex-toolkit-for-claude](../../../auditor/exemplars/xiaolai-codex-toolkit-for-claude.md), [xiaolai-grill-for-claude](../../../auditor/exemplars/xiaolai-grill-for-claude.md) **R13. System prompt structure: mission → steps → boundaries → format.** Mission in first 2 sentences. Then numbered instructions. Then what NOT to do. Then output template. > Real-world example: [AgriciDaniel-claude-seo](../../../auditor/exemplars/AgriciDaniel-claude-seo.md), [data-goblin-power-bi-agentic-development](../../../auditor/exemplars/data-goblin-power-bi-agentic-development.md), [evo-hq-evo](../../../auditor/exemplars/evo-hq-evo.md), [leowux-pony](../../../auditor/exemplars/leowux-pony.md), [viticci-shortcuts-playground-plugin](../../../auditor/exemplars/viticci-shortcuts-playground-plugin.md), [xiaolai-codex-toolkit-for-claude](../../../auditor/exemplars/xiaolai-codex-toolkit-for-claude.md) --- ## Commands **R14. Steps must be numbered.** Multi-step workflows in unnumbered prose are ambiguous. > Real-world example: [BayramAnnakov-claude-reflect](../../../auditor/exemplars/BayramAnnakov-claude-reflect.md), [SukinShetty-Nemp-memory](../../../auditor/exemplars/SukinShetty-Nemp-memory.md), [jarrodwatts-claude-hud](../../../auditor/exemplars/jarrodwatts-claude-hud.md), [karpathy-autoresearch](../../../auditor/exemplars/karpathy-autoresearch.md), [mattpocock-skills](../../../auditor/exemplars/mattpocock-skills.md), [nicknisi-claude-plugins](../../../auditor/exemplars/nicknisi-claude-plugins.md), [uppinote20-claude-dashboard](../../../auditor/exemplars/uppinote20-claude-dashboard.md) **R15. Handle empty input.** What happens when `$ARGUMENTS` is blank? Default behavior or clear error. > Real-world example: [BayramAnnakov-claude-reflect](../../../auditor/exemplars/BayramAnnakov-claude-reflect.md), [SukinShetty-Nemp-memory](../../../auditor/exemplars/SukinShetty-Nemp-memory.md), [agenticnotetaking-arscontexta](../../../auditor/exemplars/agenticnotetaking-arscontexta.md), [karpathy-autoresearch](../../../auditor/exemplars/karpathy-autoresearch.md), [taishi-i-awesome-japanese-nlp-resources](../../../auditor/exemplars/taishi-i-awesome-japanese-nlp-resources.md), [uppinote20-claude-dashboard](../../../auditor/exemplars/uppinote20-claude-dashboard.md) **R16. Define output format.** Report template with exact structure. Not "show the results." > Real-world example: [BayramAnnakov-claude-reflect](../../../auditor/exemplars/BayramAnnakov-claude-reflect.md), [CloudAI-X-claude-workflow-v2](../../../auditor/exemplars/CloudAI-X-claude-workflow-v2.md), [Dammyjay93-interface-design](../../../auditor/exemplars/Dammyjay93-interface-design.md), [OthmanAdi-planning-with-files](../../../auditor/exemplars/OthmanAdi-planning-with-files.md), [SukinShetty-Nemp-memory](../../../auditor/exemplars/SukinShetty-Nemp-memory.md), [agenticnotetaking-arscontexta](../../../auditor/exemplars/agenticnotetaking-arscontexta.md), [jarrodwatts-claude-hud](../../../auditor/exemplars/jarrodwatts-claude-hud.md), [karpathy-autoresearch](../../../auditor/exemplars/karpathy-autoresearch.md), [openai-codex-plugin-cc](../../../auditor/exemplars/openai-codex-plugin-cc.md), [quant-sentiment-ai-claude-equity-research](../../../auditor/exemplars/quant-sentiment-ai-claude-equity-research.md), [taishi-i-awesome-japanese-nlp-resources](../../../auditor/exemplars/taishi-i-awesome-japanese-nlp-resources.md), [uppinote20-claude-dashboard](../../../auditor/exemplars/uppinote20-claude-dashboard.md) **R17. Specify error paths.** Missing files, bad data, unreadable input — each needs a defined response. > Real-world example: [JuliusBrussee-cavekit](../../../auditor/exemplars/JuliusBrussee-cavekit.md), [SukinShetty-Nemp-memory](../../../auditor/exemplars/SukinShetty-Nemp-memory.md), [jarrodwatts-claude-hud](../../../auditor/exemplars/jarrodwatts-claude-hud.md), [karpathy-autoresearch](../../../auditor/exemplars/karpathy-autoresearch.md), [ooiyeefei-ccc](../../../auditor/exemplars/ooiyeefei-ccc.md), [xiaolai-codex-toolkit-for-claude](../../../auditor/exemplars/xiaolai-codex-toolkit-for-claude.md) **R18. `argument-hint` when command takes input.** Shows usage pattern in `/help`. Omit for zero-argument commands. > Real-world example: [SukinShetty-Nemp-memory](../../../auditor/exemplars/SukinShetty-Nemp-memory.md), [agenticnotetaking-arscontexta](../../../auditor/exemplars/agenticnotetaking-arscontexta.md), [openai-codex-plugin-cc](../../../auditor/exemplars/openai-codex-plugin-cc.md), [quant-sentiment-ai-claude-equity-research](../../../auditor/exemplars/quant-sentiment-ai-claude-equity-research.md), [uppinote20-claude-dashboard](../../../auditor/exemplars/uppinote20-claude-dashboard.md) --- ## Shared Partials **R19. `user-invocable: false` is mandatory.** Without it, the partial appears as a user command. **R20. `description` must state purpose.** What the partial does, which commands use it. --- ## Rules (.claude/rules/) **R21. Bold imperative + rationale.** Three parts: what to do, what goes wrong without it, why. `**Use X.** Without it, Y breaks because Z.` Bad: `Don't use any.` Good: `**Use specific types instead of any.** Without specific types, TypeScript's compiler can't catch type errors at build time, and refactoring becomes unsafe because callers and callees disagree silently.` > Real-world example: [firecrawl-firecrawl-claude-plugin](../../../auditor/exemplars/firecrawl-firecrawl-claude-plugin.md) **R22. Must be enforceable.** If you can't verify compliance in a code review, it's not a rule. Vague rules waste tokens. > Real-world example: [ReflexioAI-claude-smart](../../../auditor/exemplars/ReflexioAI-cl …(truncated)