How does this skill track implementation progress?

The skill scans your project's markdown files for checkboxes (e.g., - [x]) and calculates completion percentages based on the ratio of checked to unchecked items per feature.

What are the technical requirements for this skill?

The skill requires Node.js 18+ and the 'tsx' runtime installed globally to execute the TypeScript-based scanning and generation scripts.

Is the spec generation process destructive?

By default, the skill runs in a non-destructive mode that only generates the app-specs.md file. An optional cleanup mode is available that archives and removes original folders only after verification.

Can I use this for projects not using Next.js?

While optimized for Next.js SaaS developers, the skill is compatible with any project structure that uses markdown-based specifications and standard checkbox formatting.

Does it work with existing project files like package.json?

Yes, it can optionally extract tech stack information from package.json and database models from Prisma schemas to include in the comprehensive documentation.

App Spec & Progress Generator

Name: App Spec & Progress Generator
Author: dbalanco

bydbalanco

0•

Productivity & Workflow

Automates the generation of comprehensive project documentation and visual progress dashboards by scanning feature specifications and implementation plans.

The App Spec & Progress Generator streamlines the documentation workflow by consolidating fragmented feature specifications into a single, authoritative app-specs.md file. It automatically parses markdown checkboxes to calculate real-time completion percentages, organizes features into logical categories, and provides a high-level status dashboard. This tool is essential for developers using Claude Code who want to maintain a clear source of truth for project health and communicate implementation progress to stakeholders without manual data entry.

Key Features

01Automated spec scanning and parsing of requirements and implementation plans

02Visual status dashboards categorized by feature type and implementation state

030 GitHub stars

04Safe archival and consolidation of legacy documentation folders with rollback support

05Tech stack and database schema extraction from existing project files

06Real-time progress tracking using markdown checkbox completion metrics

Use Cases

01Generating project-wide status reports for stakeholders at the end of a sprint

02Tracking granular implementation progress across complex, multi-feature development cycles

03Consolidating fragmented feature specifications into a single source of truth

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dbalanco/perseon-marketplace app-spec-generator

For use in Claude.ai and ChatGPT

Download Skill