Agent skill

Openspec Schema Authoring

by intent-driven-dev in intent-driven-dev/openspec-schemas

Create or customize OpenSpec workflow schemas in this repository using openspec schema init and openspec schema fork.

MITAuto-check passed

Install Openspec Schema Authoring

skills CLI
$ npx skills add intent-driven-dev/openspec-schemas --skill openspec-schema-authoring -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install intent-driven-dev/openspec-schemas openspec-schema-authoring --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/intent-driven-dev/openspec-schemas.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/openspec-schema-authoring .claude/skills/openspec-schema-authoring && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
openspec-schema-authoring
GitHub stars
105
Token cost
~757 tokens
SKILL.md length
294 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Create or customize OpenSpec workflow schemas in this repository using openspec schema init and openspec schema fork.

  • Works in 7 steps: Choose whether you're starting fresh or… → Discover available schema sources → Option A: Create a new schema from… → …
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Openspec Schema Authoring is an agent skill from intent-driven-dev/openspec-schemas. Create or customize OpenSpec workflow schemas in this repository using openspec schema init and openspec schema fork.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires openspec CLI.

The repository describes itself as: Collection of OpenSpec Custom Schema for Workflows other than standard spec-driven schema that is included in OpenSpec. The licence is MIT.

Example prompts

  • “/openspec-schema-authoring”

Requirements

  • Compatibility (from SKILL.md): Requires openspec CLI.

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Choose whether you're starting fresh or forking
  2. Discover available schema sources
  3. Option A: Create a new schema from scratch (init)
  4. Option B: Customize an existing workflow (fork)
  5. Edit schema internals (minimal expectations)
  6. Validate the schema locally (required quality gate)
  7. Debug schema resolution (if validation or behavior is surprising)

What it can do on your machine

Read from SKILL.md and the folder at commit 4bb6de2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires openspec CLI.

    From compatibility in the SKILL.md frontmatter.

Context cost

Openspec Schema Authoring loads about 757 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 294 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~757

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from intent-driven-dev/openspec-schemas at commit 4bb6de2, republished under its MIT licence (© intent-driven-dev). 294 words, ~757 tokens.

Download SKILL.mdSave it as .claude/skills/openspec-schema-authoring/SKILL.md (or your agent's skills folder).
name
openspec-schema-authoring
description
Create or customize OpenSpec workflow schemas in this repository using `openspec schema init` and `openspec schema fork`.
compatibility
Requires openspec CLI.
license
MIT
metadata.author
openspec-schemas
metadata.version
1.0

Use this skill when you want to add or customize an OpenSpec workflow schema in this repository.

Goal: produce a copyable schema folder under openspec/schemas/<schema-name>/ containing schema.yaml and templates/.

Steps

  1. Choose whether you're starting fresh or forking

    If you want a brand-new workflow schema, use init. If you want to customize an existing workflow (recommended), use fork.

  2. Discover available schema sources

    List schemas available to fork (both this repo and upstream packages):

    bash
    openspec schemas --json
  3. Option A: Create a new schema from scratch (init)

    Create a new project-local schema folder:

    bash
    openspec schema init <schema-name>

    Common flags:

    • --description "..." to describe the workflow
    • --artifacts "proposal,specs,design,tasks" to set the artifact IDs (comma-separated)
    • --default to set the schema as the project default
    • --no-default to skip the interactive prompt to set as default

    Result (expected): openspec/schemas/<schema-name>/schema.yaml and openspec/schemas/<schema-name>/templates/.

  4. Option B: Customize an existing workflow (fork)

    Copy an existing schema into this repo so you can edit it:

    bash
    openspec schema fork <source> [new-schema-name]

    Sources can be:

    • A schema already in this repo (e.g., minimalist, event-driven)
    • A built-in upstream schema provided by the CLI (e.g., spec-driven, tdd)

    Result (expected): a new folder under openspec/schemas/<new-schema-name>/ containing schema.yaml + templates/.

  5. Edit schema internals (minimal expectations)

    When updating openspec/schemas/<schema-name>/schema.yaml and templates, ensure:

    • artifacts[].id matches the intended workflow sequence
    • artifacts[].requires matches dependencies
    • artifacts[].generates matches output paths that templates will create
    • Template files exist under openspec/schemas/<schema-name>/templates/ for each artifact
  6. Validate the schema locally (required quality gate)

    Run validation for every schema you changed:

    bash
    openspec schema validate <schema-name>

    Note: some CLI versions mention openspec schema review, but this repo's workflow standardizes on openspec schema validate.

  7. Debug schema resolution (if validation or behavior is surprising)

    Confirm which schema folder the CLI is using:

    bash
    openspec schema which <schema-name>

Guardrails

  • Prefer openspec schema fork over manual copying.
  • Keep schemas as copyable, repository-local folders under openspec/schemas/.
  • Always run openspec schema validate before opening a PR.

© intent-driven-dev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .opencode/skills/openspec-schema-authoring of intent-driven-dev/openspec-schemas.

Open the folder on GitHubat commit 4bb6de2

Compare with similar skills

Openspec Schema Authoring next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Openspec Schema Authoring compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Openspec Schema Authoring this skillintent-driven-dev/openspec-schemas105—~757Automated safety check: PassMIT
Author Bylinethedaviddias/Front-End-Checklist74k—~409Automated safety check: PassMIT
Author Expertisethedaviddias/Front-End-Checklist74k—~438Automated safety check: PassMIT
Author Infothedaviddias/Front-End-Checklist74k—~422Automated safety check: PassMIT
Hermes Agent Skill AuthoringNousResearch/hermes-agent252k—~3.6kAutomated safety check: PassMIT
Configuring Oauth2 Authorization Flowmukul975/Anthropic-Cybersecurity-Skills34k—~1.7kAutomated safety check: PassApache-2.0

Similar skills

  • Author Byline

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing metadata, crawlability, structured data, or indexability related to Display clear author bylines.

    74k GitHub stars~409 tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Author Expertise

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing metadata, crawlability, structured data, or indexability related to Highlight author credentials and expertise.

    74k GitHub stars~438 tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Author Info

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing metadata, crawlability, structured data, or indexability related to Implement comprehensive author markup.

    74k GitHub stars~422 tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Hermes Agent Skill Authoring

    NousResearch/hermes-agent

    Author in-repo SKILL.md files: frontmatter and structure. An agent skill from NousResearch/hermes-agent.

    252k GitHub stars~3.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Configuring Oauth2 Authorization Flow

    mukul975/Anthropic-Cybersecurity-Skills

    Configures secure OAuth 2.0 authorization flows, including Authorization Code with PKCE, Client Credentials, and Device Authorization Grant, covering flow selection, PKCE implementation, token…

    34k GitHub stars~1.7k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Customer Support Agent

    mastra-ai/mastra

    Authoring playbook for building agents that triage and reply to customer messages — support tickets, email inquiries, chat questions, refund requests, or product issues.

    29k GitHub stars~2.2k tokensUpdated today
    Sales & SupportAuto-check passed

More from intent-driven-dev/openspec-schemas

  • Openspec Linearized

    intent-driven-dev/openspec-schemas

    A skill your agent uses whenever Codex operates on an OpenSpec change lifecycle or artifact, including propose/new change, apply/implement tasks, archive/finalize, sync specs, continue/update…

    105 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Openspec Schema Authoring

    intent-driven-dev/openspec-schemas

    Create or customize OpenSpec workflow schemas in this repository using openspec schema init and openspec schema fork.

    105 GitHub stars~674 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Openspec Schema Authoring

What does Openspec Schema Authoring do?

Create or customize OpenSpec workflow schemas in this repository using openspec schema init and openspec schema fork. Openspec Schema Authoring is an agent skill from intent-driven-dev/openspec-schemas. Create or customize OpenSpec workflow schemas in this repository using openspec schema init and openspec schema fork.

How do I install Openspec Schema Authoring in Claude Code?

Run `npx skills add intent-driven-dev/openspec-schemas --skill openspec-schema-authoring -a claude-code`. Or copy the skill folder (.opencode/skills/openspec-schema-authoring in intent-driven-dev/openspec-schemas) into .claude/skills/openspec-schema-authoring in your project. Claude Code loads it when a task matches its description.

How do I install Openspec Schema Authoring in Codex?

Run `npx skills add intent-driven-dev/openspec-schemas --skill openspec-schema-authoring -a codex`. Or copy the skill folder (.opencode/skills/openspec-schema-authoring in intent-driven-dev/openspec-schemas) into .agents/skills/openspec-schema-authoring in your project. Codex loads it when a task matches its description.

Can I use Openspec Schema Authoring in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add intent-driven-dev/openspec-schemas --skill openspec-schema-authoring -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/openspec-schema-authoring, .gemini/skills/openspec-schema-authoring, .github/skills/openspec-schema-authoring and .opencode/skills/openspec-schema-authoring in your project.

What does Openspec Schema Authoring need to run?

SKILL.md names no scripts, command-line tools or credentials: Openspec Schema Authoring is instructions for the agent only. Compatibility (from SKILL.md): Requires openspec CLI..

Does Openspec Schema Authoring access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Openspec Schema Authoring safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Openspec Schema Authoring use?

Openspec Schema Authoring is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Openspec Schema Authoring use?

About 757 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Openspec Schema Authoring?

Skills that share tags, products or a category with Openspec Schema Authoring: Author Byline (thedaviddias/Front-End-Checklist, 74k stars), Author Expertise (thedaviddias/Front-End-Checklist, 74k stars), Author Info (thedaviddias/Front-End-Checklist, 74k stars) and Hermes Agent Skill Authoring (NousResearch/hermes-agent, 252k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Openspec Schema Authoring?

intent-driven-dev (a GitHub organization) maintains it in intent-driven-dev/openspec-schemas, which has 105 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on August 16, 2026.

Source: intent-driven-dev/openspec-schemas on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.