Agent skill · product strategy · aiskillstore
feature-file
Manage features.yml for tracking requirements and progress; use proactively ONLY when features.yml already exists, or invoke manually to create one; complements TodoWrite for persistent project state.
Why this skill is useful
Adds a structured approach to managing feature requirements and progress tracking that the AI wouldn't reliably generate on its own.
What it needs
About 4k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Feature File Management Manage features.yml - a waterfall-style planning document combining structured requirements tracking with incremental development. Quick Reference See references/schema.md for complete field documentation. Proactive Usage This skill should be used automatically when features.yml exists. Before Starting Implementation 1. Check if features.yml exists in project root 2. If missing: do not use this skill proactively (stop here) 3. Plan the work in features.yml before writing code: Add/update the feature with all requirements extracted from the user's request Add anticipated test cases to test-cases (with passing: false) Document design decisions in decisions if non-trivial choices are involved 4. Set the first requirement to status: In-Progress During Implementation Update status to Complete as requirements are finished Add test cases to test-cases when writing tests Update passing field after running tests Add discovered issues to known-issues After Completing Work Verify all implemented requirements are marked Complete Run ./scripts/feature-status.py --validate to check consistency Commit features.yml changes with the implementation Relationship with TodoWrite Tool Purpose Persistence ------ --------- ------------- TodoWrite Immediate session actions Ephemeral features.yml Requirements and progress Persistent (in repo) Use both: TodoWrite for what to do now, features.yml for durable project state. Phase Transitions From To Conditions ------ ---- ------------ Requirements Design All requirements have descriptions Design Implementation decisions field exists (use [] if none needed) Implementation Testing All requirements In-Progress or Complete Testing Complete All requirements Complete AND all tests passing: true Scripts validate these rules and report errors. Workflows Agent Workflow (Condensed) 1. ls features.yml → exists? Read it : Create it 2. Plan first: Add feature, requirements, test-cases, decisions 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/feature-file