behavior-spec-writing

Draft Gherkin behavior specifications from docs/plan and lint them with gherkin-lint.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/ytqh/agent-skills --skill behavior-spec-writing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: behavior-spec-writing
Source: https://github.com/ytqh/agent-skills/tree/main/skills/behavior-spec-writing
Command: npx skills add https://github.com/ytqh/agent-skills --skill behavior-spec-writing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables teams to define and maintain clear, reusable behavior specifications (Gherkin-based) for features and core modules, preventing ambiguity during development and ensuring consistent expectations across teams.

Core Features & Use Cases

  • Automated spec drafting: generate structured Feature and Core specs from planning docs (docs/plan) and existing modules.
  • Linted, production-ready outputs: verify new/updated specs with gherkin-lint and store them under docs/spec/feature-spec/ and docs/spec/core-spec/.
  • Knowledge memory: preserve system behavior definitions to guide implementation and future changes.

Quick Start

Use the behavior-spec-writing skill to draft a new spec by reading docs/plan, producing or updating docs/spec/feature-spec/{feature-name}.feature and docs/spec/core-spec/{module}.feature, run lint, and present for review.

Frequently Asked Questions about behavior-spec-writing

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

FAQPage Schema
How do I generate Gherkin behavior specs from an implementation plan?

To generate Gherkin behavior specs, the Skill reads your implementation plan from docs/plan and drafts structured feature and core module specifications. It outputs these files under docs/spec/feature-spec/ and docs/spec/core-spec/ for review.

What is the best way to lint feature-spec files during development?

The best way to lint feature-spec files is using gherkin-lint to validate new or updated behavior specifications. This ensures your Gherkin outputs conform to the project's standard format and workflow before they are stored as memory.

Can I use this to draft core-spec files for existing modules?

Yes, you can draft core-spec files for existing modules. The Skill reads planning documents and produces core specs under docs/spec/core-spec/, ensuring consistent expectations and reusability across different modules in your project.

Do I need a docs/plan directory to write behavior specifications?

Yes, a docs/plan directory is required because the Skill reads the implementation plan from that location to produce feature and core specs. Without it, the tool lacks the context needed to draft the Gherkin behavior specifications.

How does storing behavior specs as memory guide future implementation?

Storing behavior specs as memory preserves system behavior definitions under docs/spec. This knowledge memory guides future implementation and changes by maintaining reusable, linted Gherkin feature and core specs that prevent ambiguity across teams.