spec-mode

Manage specification-driven development workflows for CLI agents with Markdown and Obsidian.

Updated Apr 26, 2026

Search Tags:#CLI #Obsidian #Markdown #specification-driven development #CLI agent

Ready to run

npx skills add https://github.com/qxbyte/skills --skill spec-mode-qxbyte

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: spec-mode
Source: https://github.com/qxbyte/skills/tree/main/spec-mode
Command: npx skills add https://github.com/qxbyte/skills --skill spec-mode-qxbyte

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a structured, specification-driven workflow for CLI agents, ensuring that requirements, designs, and tasks are clearly documented and managed throughout the development process.

Core Features & Use Cases

Specification-Driven Development: Guides the user through a structured workflow for creating, reviewing, and updating specifications.
Markdown-based Documents: Generates Markdown files for requirements, designs, tasks, and acceptance checklists.
Integration with Obsidian: Allows storing and managing spec documents within an Obsidian vault.
Session Management: Offers session persistence for ongoing work.
Multi-window Support: Allows parallel work on different specs across different agent windows.

Quick Start

To start a new spec session, use the command /spec <requirement>.

Frequently Asked Questions about spec-mode

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

FAQPage Schema

How do I manage specification-driven development workflows for CLI agents like Codex or Claude Code?▼

Specification-driven development workflows for CLI agents are managed by generating structured Markdown files for requirements, designs, and tasks, ensuring documentation persists across coding sessions with assistants like Codex and Claude Code.

Can I store and manage Markdown specification documents inside an Obsidian vault?▼

Yes, you can store and manage Markdown specification documents inside an Obsidian vault, allowing you to integrate structured development specs directly into your existing note-taking and knowledge base environment.

What is the best way to maintain persistent development sessions for CLI coding assistants?▼

Persistent development sessions for CLI coding assistants are maintained through built-in session management features that save your progress and support multi-window workflows for parallel spec editing.

Do I need Python to run a specification-driven workflow for CLI agents?▼

Yes, Python is required as a dependency to run this specification-driven workflow, executing the underlying scripts that generate and manage your Markdown-based requirements and design documents.

How do I start a new specification session for a software requirement?▼

You start a new specification session by submitting a command with your specific requirement, which triggers the CLI agent to generate the initial structured Markdown documents for your project.

What are the limitations of using Markdown for specification-driven development with CLI agents?▼

The primary limitation is that Markdown-based specification-driven development requires manual integration with your Obsidian vault and relies heavily on the CLI agent's ability to parse and update plain text documents consistently.