# specsfy-aux-stack

Creates or updates .specsfy/STACK.md from project manifests and configs. It tracks structural technology changes while keeping human-written notes intact.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 819 installs · ★ 87
- Author: promovaweb
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/promovaweb/specsfy/tree/HEAD/skills/specsfy-aux-stack/SKILL.md
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/skills/specsfy-aux-stack

## What it 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`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add promovaweb/specsfy --skill specsfy-aux-stack -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/specsfy-aux-stack/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/specsfy-aux-stack/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add promovaweb/specsfy --skill specsfy-aux-stack -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/specsfy-aux-stack/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add promovaweb/specsfy --skill specsfy-aux-stack -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/specsfy-aux-stack/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install promovaweb/specsfy specsfy-aux-stack
```

2. **Manually: put the files in place**
- File: `.github/skills/specsfy-aux-stack/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add promovaweb/specsfy --skill specsfy-aux-stack -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/promovaweb/specsfy --path skills/specsfy-aux-stack
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/specsfy-aux-stack/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add promovaweb/specsfy --skill specsfy-aux-stack -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/promovaweb/specsfy/tree/HEAD/skills/specsfy-aux-stack/SKILL.md

## When to use it
- 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
- 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

## Similar
- [technology-stack-blueprint-generator](https://affpapa.org/en/nevibecode/skills/technology-stack-blueprint-generator.md) — skill · 9000 installs
- [sentry-fix-stack-traces](https://affpapa.org/en/nevibecode/skills/sentry-fix-stack-traces.md) — skill · 1500 installs
- [using-ui-stack](https://affpapa.org/en/nevibecode/skills/using-ui-stack.md) — skill · 539 installs
- [stack](https://affpapa.org/en/nevibecode/skills/stack.md) — skill · 474 installs
- [revops-stack-rationalization](https://affpapa.org/en/nevibecode/skills/revops-stack-rationalization.md) — skill · 20000 installs
- [gh-stack](https://affpapa.org/en/nevibecode/skills/gh-stack.md) — skill · 18800 installs

From the same set: [promovaweb/specsfy](https://affpapa.org/en/nevibecode/by/promovaweb/specsfy.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md