specsfy-aux-rules — Claude Code skill: what it does, how to install
Formulates and records lasting project rules in .specsfy/RULES.md. It asks clarifying questions and avoids modifying or removing existing guidelines.
npx skills add promovaweb/specsfy --skill specsfy-aux-rules -a claude-codeWhat specsfy-aux-rules does
This skill manages the .specsfy/RULES.md file by turning recurring conventions into documented rules. It reads PROJECT.md alongside existing instructions to separate declared rules from assumptions. If a rule needs clarification, it uses numbered questions defined in .specsfy/Spec.md. Every rule must have an action verb and clear boundaries.
Validated entries are saved using node scripts/add_rule.mjs --project <raiz> --section "<tema>" --rule "<regra confirmada>". This helper preserves section ordering and earlier guidelines. If a newly proposed instruction contradicts an older one, the skill flags the issue instead of silently picking a winner.
Running $specsfy-setup in the project root is mandatory before execution, and any pending setup issue blocks the workflow immediately. The skill forbids storing secrets or personal data in RULES.md, and it must not serve as a replacement for AGENTS.md or acceptance criteria.
What it helps with
- document recurring team conventions in
.specsfy/RULES.md - spot contradictions between new instructions and older rules
- phrase verifiable project instructions via structured questions
- insert confirmed guidelines into sections with
scripts/add_rule.mjs
Example prompts for the agent
- Turn our module structure convention into a formal rule in RULES.md
- Review these instructions for conflicts with our existing project rules
How to install specsfy-aux-rules
1Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-rules -a claude-code2Manually: put the files in place
~/.claude/skills/specsfy-aux-rules/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/specsfy-aux-rules/
1Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-rules -a codex2Manually: put the files in place
.agents/skills/specsfy-aux-rules/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-rules -a cursor2Manually: put the files in place
.cursor/skills/specsfy-aux-rules/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install promovaweb/specsfy specsfy-aux-rules2Manually: put the files in place
.github/skills/specsfy-aux-rules/SKILL.md1Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-rules -a gemini-cli2Platform CLI
gemini skills install https://github.com/promovaweb/specsfy --path skills/specsfy-aux-rulesManually: put the files in place
.devin/skills/specsfy-aux-rules/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-rules -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about specsfy-aux-rules
How to install specsfy-aux-rules in Claude Code?
Run npx skills add promovaweb/specsfy --skill specsfy-aux-rules -a claude-code.
What does specsfy-aux-rules do?
It analyzes project context, asks clarifying questions, and registers persistent instructions in .specsfy/RULES.md without altering earlier entries.
What is required before running specsfy-aux-rules?
You must run $specsfy-setup in the project root first. The skill halts if any setup issues remain unresolved.
