skills.rest
DMokong
DMokongCOMMUNITY
Explore all skills by this author →
GitHub

spec-create

Create a formal spec.md and isolated Git worktree for new features.

Updated Mar 5, 2026
Search Tags:#git#development#documentation#worktree#spec#feature
One-click install
npx skills add https://github.com/DMokong/speculator --skill spec-create-dmokong
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-create
Source: https://github.com/DMokong/speculator/tree/main/skills/spec-create
Command: npx skills add https://github.com/DMokong/speculator --skill spec-create-dmokong

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the initiation of new development tasks by creating a formal specification document and setting up an isolated work environment.

Core Features & Use Cases

  • Formal Spec Generation: Creates a new spec.md file from a template, including essential metadata like ID, status, author, and date.
  • Worktree Isolation: Sets up a dedicated Git worktree for each new feature, preventing conflicts and allowing parallel development.
  • Traceability: Integrates with beads to create an epic for the new feature, linking the spec to the overall development lifecycle.

Quick Start

Run /spec start to begin a new feature with a formal specification and isolated worktree.

Frequently Asked Questions about spec-create

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

FAQPage Schema
How do I create a formal specification document for a new Git feature?▼

To create a formal specification document for a new Git feature, run the /spec start command. This generates a spec.md file populated with essential metadata like ID, status, author, and date.

What is Git worktree isolation and when do I need it for feature development?▼

Git worktree isolation sets up a dedicated working directory for each new feature, preventing branch conflicts. You need it when running parallel development tasks to keep features separate.

Does this spec creation workflow integrate with beads for epic traceability?▼

Yes, the spec creation workflow integrates directly with beads to create an epic for the new feature. This links the generated specification document to the overall development lifecycle.

Can I manage parallel development branches without worktree conflicts?▼

You can manage parallel development without conflicts by using isolated Git worktrees. This approach establishes a dedicated work environment for each feature, preventing overlapping changes.

What is the best way to start a new development feature with formal specs?▼

The best way to start a new development feature with formal specs is to automate spec ID generation, template population, and worktree creation simultaneously, ensuring immediate traceability.

Related Skills

Explore More Software Engineering Skills→
miguelarcjrmiguelarcjr

using-git-worktrees

Create isolated development workspaces using native tools or git worktree fallback.

Community
Advanced
GregoryHoGregoryHo
6

arc-using-worktrees

Create isolated Git worktrees for epic development within the arcforge framework.

Community
Advanced
wizactwizact

worktree

Automate Git worktree creation, cleanup, and synchronization for feature branches.

Community
Advanced
mahoushoujyo-eeemahoushoujyo-eee
15

using-git-worktrees

Create an isolated Git worktree for feature development with baseline tests.

Community
Advanced