What file types does the scanner look for?

The generator specifically scans for requirements.md and implementation-plan.md files within your defined project specification directories.

Can I use this without global TSX installation?

The skill requires Node.js 18+ and the tsx runtime; it is recommended to install tsx globally for the CLI scripts to function correctly.

How does the skill calculate progress?

It parses markdown files within your spec folders and calculates a completion percentage based on the ratio of checked [x] versus unchecked [ ] checkboxes.

Is it safe to use the cleanup mode?

Yes, the cleanup mode includes safety features like mandatory archiving of folders before deletion, validation of the archive, and automatic rollback if the operation fails.

App Spec Generator

Name: App Spec Generator
Author: dbalanco

bydbalanco

0•

学習とドキュメンテーション

Automatically generates comprehensive project documentation and progress dashboards by scanning feature specifications and implementation plans.

The App Spec Generator is a powerful documentation utility for Claude Code that centralizes scattered feature specifications into a single, cohesive source of truth. By parsing markdown checkboxes across multiple directories, it calculates real-time implementation progress, categorizes features, and builds a visual status dashboard. This skill is ideal for developers and project leads who need to maintain accurate project roadmaps, track feature completion metrics, and provide stakeholders with clear progress visibility without the manual overhead of updating documentation.

主な機能

01Real-time progress tracking via markdown checkbox completion analysis

020 GitHub stars

03Automatic feature categorization based on project directory structures

04Automated scanning of feature folders for requirements and implementation plans

05Generation of centralized app-specs.md with visual status dashboards

06Safe archival and cleanup workflows for consolidating project documentation

ユースケース

01Generating high-level progress reports for stakeholders during a development sprint

02Automating the tracking of implementation tasks across a complex codebase

03Consolidating multiple feature-specific markdown files into a single project overview

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dbalanco/claude-code app-spec-generator

For use in Claude.ai and ChatGPT

Download Skill