This skill should be used when the user asks to "update app specs", "generate documentation", "track feature progress", "create status dashboard", "consolidate spec files", or mentions updating project documentation after completing features. Automatically scans feature specifications, tracks implementation progress via checkboxes, and generates comprehensive app-specs.md documents with progress dashboards by category.
Inherits all available tools
Additional assets for this skill
This skill inherits all available tools. When active, it can use any tool Claude has access to.
references/advanced-usage.mdreferences/configuration.mdreferences/output-format.mdreferences/troubleshooting.mdscripts/generator.tsscripts/index.tsscripts/parser.tsscripts/scanner.tsscripts/types.tsscripts/update.tsAutomatically scan feature specification folders, parse implementation plans, calculate completion percentages from markdown checkboxes, and generate comprehensive app-specs.md documentation with progress tracking, categorization, and status dashboards.
This skill transforms scattered feature specifications into a single source of truth with visual progress indicators, making it easy to track project completion and share status with stakeholders.
Recursively scan project spec directories to:
requirements.md and implementation-plan.md files[x] vs [ ]) to calculate completion percentagesAnalyze implementation status across all features:
Create structured app-specs.md with these sections:
Safely consolidate documentation with these safety features:
The recommended way to use this skill:
/update-specs
This scans spec folders in /specs/, generates app-specs.md, and leaves original folders intact (non-destructive mode).
Run the TypeScript script manually:
tsx ${CLAUDE_PLUGIN_ROOT}/skills/app-spec-generator/scripts/update.ts
ā ļø Warning: Archives and removes spec folders after generation.
tsx ${CLAUDE_PLUGIN_ROOT}/skills/app-spec-generator/scripts/update.ts --cleanup
Use cleanup mode only when consolidating all documentation into the single app-specs.md file.
The generator expects this structure:
project-root/
āāā perseon/
ā āāā specs/
ā āāā feature-1/
ā ā āāā requirements.md
ā ā āāā implementation-plan.md
ā āāā feature-2/
ā ā āāā requirements.md
ā ā āāā implementation-plan.md
ā āāā app-specs.md ā Generated output
āāā package.json ā Optional: for tech stack
āāā prisma/
āāā schema.prisma ā Optional: for database schema
Features are automatically categorized based on folder names:
| Category | Folder Keywords |
|---|---|
| Foundation | auth, workspace, database |
| GitHub Integration | github, git |
| Project Management | project, kanban, issue |
| Community Features | community, feature-request, upvote |
| Analytics & Monitoring | analytics, monitor, dashboard |
| UX Enhancements | ux, ui, enhancement, dark-mode |
| Performance | performance, optimization, cache |
| Learning Resources | tutorial, learning, guide |
| Developer Tools | cli, command, tool, generator |
| Notifications | notification, email, alert |
| Other | default for unmatched folders |
The parser recognizes these status indicators in markdown:
ā
emoji in titleš” emojiā³ emojiā emojiCheckbox format must be: - [x] (completed) or - [ ] (pending) with space between - and [.
When a user asks to update specs or generate documentation:
tsx is installed globally/specs/ exists or ask for custom pathtsx ${CLAUDE_PLUGIN_ROOT}/skills/app-spec-generator/scripts/update.ts
Generates or updates app-specs.md without modifying spec folders.
Ask user for explicit confirmation before running:
tsx ${CLAUDE_PLUGIN_ROOT}/skills/app-spec-generator/scripts/update.ts --cleanup
Explain that this will:
/specs/.archive/[timestamp]//specs/app-specs.md as the documentation sourceThe skill includes these core modules in scripts/:
For detailed configuration and advanced usage, consult:
references/configuration.md - Custom paths, categories, exclusionsreferences/output-format.md - Generated document structure detailsreferences/troubleshooting.md - Common issues and solutionsreferences/advanced-usage.md - Programmatic API and customizationImplementation scripts available in scripts/:
tsx runtimeWhen using cleanup mode, these protections activate:
ā Archive First - All folders backed up before deletion ā Validation - Archive checked for completeness ā Exclusions - Critical folders never deleted ā Rollback - Automatic restoration if cleanup fails ā Atomic Operations - Completes fully or rolls back entirely
Archive location: /specs/.archive/[timestamp]/
app-specs.md before cleanuptsx is installed globallynpm install -g tsx or pnpm add -g tsx)