openspec-main-spec-format — community openspec-main-spec-format, cli2docker, community, ide skills, Claude Code, Cursor, Windsurf

v1.0
GitHub

About this Skill

Perfect for Technical Writing Agents needing structured documentation capabilities for openspec specifications Install CLI npm utils as docker container for increased security

timurb timurb
[0]
[0]
Updated: 3/5/2026

Agent Capability Analysis

The openspec-main-spec-format skill by timurb is an open-source community AI agent skill for Claude Code and other IDE workflows, helping agents execute tasks with better context, repeatability, and domain-specific guidance.

Ideal Agent Persona

Perfect for Technical Writing Agents needing structured documentation capabilities for openspec specifications

Core Value

Empowers agents to create and manage openspec documentation using a split-file format with normative tests in `spec.md` and feature descriptions in `feature.md`, utilizing markdown links and Docker containers for increased security

↓ Capabilities Granted for openspec-main-spec-format

Generating capability documentation with normative tests and scenarios
Creating feature descriptions with overview, context, and usage workflows
Validating and updating openspec documentation for consistency and accuracy

! Prerequisites & Limits

  • Requires installation of CLI npm utils as a Docker container
  • Limited to openspec specifications under `openspec/specs/<capability>/` directory
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

openspec-main-spec-format

Install openspec-main-spec-format, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command...

SKILL.md
Readonly

When creating or updating capability docs under openspec/specs/<capability>/, use a split-file format:

  1. spec.md (normative tests only)

    • Purpose (1–3 sentences)
    • Requirements/Scenarios (normative)
    • Links to sibling docs (markdown links)

  2. feature.md (black + white box in one file)

    • Overview / Context / Problems addressed
    • Goals / Non-Goals (or In scope / Out of scope)
    • Usage workflows / scenarios beyond tests
    • Success criteria (if applicable)
    • Architecture description
    • Constraints
    • Entities
    • Interfaces (Inputs/Outputs)
    • Invariants (if applicable)
    • Events / Triggers
    • Links to sibling docs (markdown links)

Cross-links are recommended in all files:

  • Link to sibling docs within the same capability
  • Link across capabilities when concepts are shared Use markdown links (e.g., [feature](feature.md)), not backticked filenames.

Keep spec.md lean; requirements and scenarios are the normative tests.

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is openspec-main-spec-format?

Perfect for Technical Writing Agents needing structured documentation capabilities for openspec specifications Install CLI npm utils as docker container for increased security

How do I install openspec-main-spec-format?

Run the command: npx killer-skills add timurb/cli2docker/openspec-main-spec-format. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for openspec-main-spec-format?

Key use cases include: Generating capability documentation with normative tests and scenarios, Creating feature descriptions with overview, context, and usage workflows, Validating and updating openspec documentation for consistency and accuracy.

Which IDEs are compatible with openspec-main-spec-format?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for openspec-main-spec-format?

Requires installation of CLI npm utils as a Docker container. Limited to openspec specifications under `openspec/specs/<capability>/` directory.

↓ How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add timurb/cli2docker/openspec-main-spec-format. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use openspec-main-spec-format immediately in the current project.

Related Skills

Looking for an alternative to openspec-main-spec-format or another community skill for your workflow? Explore these related open-source skills.

View All

widget-generator

Logo of f
f

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

★ 149.6k
⑂ 0
AI

flags

Logo of vercel
vercel

flags is a Next.js feature management skill that enables developers to efficiently add or modify framework feature flags, streamlining React application development.

★ 138.4k
⑂ 0
Browser

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI