feature

Generate BDD Given/When/Then feature docs from specs, plans, tests, or code.

Updated May 26, 2026
One-click install
npx skills add https://github.com/robot-denny/ai-sketchlab --skill feature-robot-denny
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature
Source: https://github.com/robot-denny/ai-sketchlab/tree/main/.agents/skills/feature
Command: npx skills add https://github.com/robot-denny/ai-sketchlab --skill feature-robot-denny

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams lose track of what a capability actually does once specs, plans, and code drift apart. This Skill produces a single living behavioral document per capability, written in business language, so QA can run regression testing and developers can onboard without reading source code. ## Core Features & Use Cases - BDD scenario generation: Writes Given/When/Then scenarios grouped under business Rules, with concrete values and no implementation jargon. - Test coverage mapping: Builds a coverage table linking each scenario to its test file and status, distinguishing covered, failing, uncovered, code-derived, and ruled-out rows. - From-code backfill: Reverse-engineers draft docs for undocumented capabilities by reading schema definitions, typed models, and views, flagging anything code cannot prove. - Use Case: After shipping a navigation component across three increments, run the Skill to consolidate scattered specs and tests into one feature doc that QA uses as the regression baseline. ## Quick Start Ask the assistant to generate a feature doc for a capability by passing a spec path, capability name, or code entity, for example: create a feature doc for the site navigation capability.

Frequently Asked Questions about feature

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate BDD scenarios from an existing codebase?

Use the from-code mode by passing a code entity with no spec or tests. The Skill reads the schema definition, typed model, and view, derives one Rule per meaningful field, and writes a draft doc flagged as reverse-engineered and unverified.

How do I write a feature doc from a spec file?

Pass the spec path as the argument. The Skill reads the spec's work-type line, locates related plans and tests, derives Rules and Given/When/Then scenarios, and saves the doc under the capability's slug.

When should a change not get its own feature doc?

Migrations, upgrades, refactors, fixes, and infrastructure work never earn new feature docs. Changes to existing capabilities update the existing capability doc instead, and fix or infra work belongs in a runbook under docs/.

What happens when a spec and a test disagree about behavior?

Test assertions take precedence as the strongest signal of actual behavior, followed by plan descriptions, then spec descriptions. The conflict is noted in the output summary and the doc reflects tested reality.

Can undocumented parts of a capability be backfilled?

Yes. During an update, the Skill compares the doc against the code and applies the from-code technique to undocumented fields and branches, marking those coverage rows as Not covered (code-derived) while leaving verified parts unchanged.