specsfy-aux-stack — Claude Code skill: what it does, how to install
Creates or updates .specsfy/STACK.md from project manifests and configs. It tracks structural technology changes while keeping human-written notes intact.
npx skills add promovaweb/specsfy --skill specsfy-aux-stack -a claude-codeWhat specsfy-aux-stack does
The skill inspects manifests and lockfiles to document architectural dependencies in .specsfy/STACK.md. It triggers node scripts/update_stack.mjs --project <raiz> and records structural tech like Next.js or Astro alongside evidence links. Full dependency trees stay out; it logs only foundational tools and their roles.
Running $specsfy-setup in the project root is mandatory beforehand, because unresolved setup flags halt execution immediately. The skill operates without asking user questions. If required details are missing, it marks them for the conversational stage instead of interrupting the run. Any database changes prompt it to load $specsfy-aux-database.
What it helps with
- record core architecture choices in .specsfy/STACK.md
- track newly introduced frameworks after codebase changes
- retain custom human notes when updating stack specs
- audit lockfiles without dumping thousands of subdependencies
Example prompts for the agent
- Run specsfy-aux-stack to document the new Astro setup in STACK.md
- Inspect package manifests and update .specsfy/STACK.md with structural dependencies
- Check stack changes after adding database persistence via specsfy-aux-stack
How to install specsfy-aux-stack
1Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-stack -a claude-code2Manually: put the files in place
~/.claude/skills/specsfy-aux-stack/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/specsfy-aux-stack/
1Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-stack -a codex2Manually: put the files in place
.agents/skills/specsfy-aux-stack/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-stack -a cursor2Manually: put the files in place
.cursor/skills/specsfy-aux-stack/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install promovaweb/specsfy specsfy-aux-stack2Manually: put the files in place
.github/skills/specsfy-aux-stack/SKILL.md1Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-stack -a gemini-cli2Platform CLI
gemini skills install https://github.com/promovaweb/specsfy --path skills/specsfy-aux-stackManually: put the files in place
.devin/skills/specsfy-aux-stack/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-stack -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-stack
How to install specsfy-aux-stack in Claude Code?
Run npx skills add promovaweb/specsfy --skill specsfy-aux-stack -a claude-code in your terminal.
What does specsfy-aux-stack do?
It reads project manifests, runs an update script, and writes structural stack data to .specsfy/STACK.md. Human comments outside the specsfy:stack section remain untouched.
What prerequisites does this skill require?
You must execute $specsfy-setup at the project root before running this skill. If setup reports pending issues, execution stops until those issues are resolved.
