skills.rest
I2olanD
I2olanDCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

specification-management

Create auto-incrementing spec directories and record decisions via spec.py.

Updated Dec 28, 2025
Search Tags:#automation#workflow#templates#documentation#specifications#README#spec-management
One-click install
npx skills add https://github.com/I2olanD/dotfiles --skill specification-management-i2oland
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: specification-management
Source: https://github.com/I2olanD/dotfiles/tree/main/.config/opencode/skill/specification-management
Command: npx skills add https://github.com/I2olanD/dotfiles --skill specification-management-i2oland

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill organizes and accelerates specification workflows by creating spec directories with auto-incrementing IDs, and by maintaining per-spec README logs to capture decisions, context, and progress.

Core Features & Use Cases

  • Create new specification directories with auto-incrementing IDs.
  • Read and update spec metadata and README to reflect decisions and phase transitions.
  • Manage phase transitions (PRD → SDD → PLAN) and track documents.
  • Initialize or update README.md in spec directories and use spec.py for operations.

Quick Start

Use the spec.py script to create or manage specs. For example: ~/.config/opencode/skill/specification-management/spec.py 'feature-name' ~/.config/opencode/skill/specification-management/spec.py 004 --read

Frequently Asked Questions about specification-management

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

FAQPage Schema
How do I manage PRD to SDD to PLAN phase transitions for my specs?▼

To manage PRD to SDD to PLAN phase transitions, use the specification management skill to read and update spec metadata. It records phase changes in the README to track document progress across the workflow.

Can I check the status and record decisions for an existing specification?▼

Yes, you can check status and record decisions by running the spec.py script with the spec ID and the --read flag. This retrieves current metadata and allows you to append decisions to the README log.

What is the best way to maintain README logs for specification directories?▼

The best way to maintain README logs for specification directories is through the spec.py script, which automatically initializes and updates the README file to capture decisions, context, and progress during spec creation and phase transitions.

Do I need any external dependencies to automate spec directory creation?▼

No external dependencies are required to automate spec directory creation. The skill operates standalone using the spec.py script to generate directories, assign auto-incrementing IDs, and output metadata without external packages.

Related Skills

Explore More Content & Communication Skills→
dhofheinzdhofheinz
9

Plugin Scaffold Skill

Generate complete plugin directory structures with manifest, README, LICENSE, and CHANGELOG files.

Community
Basic
ReefBytes-OwnerReefBytes-Owner
1

plan-manage

Coordinate plan lifecycle workflows across .claude/.plans with create, review, execute, archive, and abandon operations.

Community
Advanced
windyskywindysky

moai-docs-generation

Generate documentation patterns from code for Sphinx, MkDocs, TypeDoc, and Nextra.

Community
Advanced
richardcbrichardcb
15

conductor-setup

Initialize Conductor workflow configuration files and directory structures.

Community
Intermediate