New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Draft Openspec Docs

by goern in goern/forgejo-mcp

Collaborative page-drafting mode for the OpenSpec docs. An agent skill from goern/forgejo-mcp.

GPL-3.0Auto-check passed

Install Draft Openspec Docs

skills CLI
$ npx skills add goern/forgejo-mcp --skill draft-openspec-docs -a claude-code

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

GitHub CLI
$ gh skill install goern/forgejo-mcp draft-openspec-docs --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/goern/forgejo-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/draft-openspec-docs .claude/skills/draft-openspec-docs && 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
draft-openspec-docs
GitHub stars
140
Used in
1 other repo
Token cost
~815 tokens
SKILL.md length
440 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
GPL-3.0

At a glance

Collaborative page-drafting mode for the OpenSpec docs. An agent skill from goern/forgejo-mcp.

  • Works in 4 steps: Set up the scratch section → Iterate until the plan is approved → Add the draft plan, then draft step by… → …
  • A page needs a from-scratch rewrite
  • SKILL.md covers 1. Set up the scratch section, 2. Iterate until the plan is…, 3. Add the draft plan, then… and 4. Consolidation and cleanup
  • Calls node

What it does

Draft Openspec Docs is an agent skill from goern/forgejo-mcp. Collaborative page-drafting mode for the OpenSpec docs. Builds a scratch plan inside the target page (purpose, structure, numbered draft steps), iterates on it with the user, then drafts one section per approved step and cleans up after itself. Use when a page needs a from-scratch rewrite or a new page is being shaped with the user in the loop.

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: MIRROR ONLY!! This Model Context Protocol (MCP) server provides tools and resources for interacting with the Forgejo (specifically Codeberg.org) REST API. The licence is GPL-3.0.

When your agent uses it

  • A page needs a from-scratch rewrite
  • A new page is being shaped with the user in the loop

Example prompts

  • “/draft-openspec-docs”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Set up the scratch section
  2. Iterate until the plan is approved
  3. Add the draft plan, then draft step by step
  4. Consolidation and cleanup

What it can do on your machine

Read from SKILL.md and the folder at commit 64a14bc. 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

    Shell commands in SKILL.md call:

    • node

    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.

Context cost

Draft Openspec Docs loads about 815 tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 440 words of instructions outside code blocks.

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

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 goern/forgejo-mcp at commit 64a14bc, republished under its GPL-3.0 licence (© goern). 440 words, ~815 tokens.

Download SKILL.mdSave it as .claude/skills/draft-openspec-docs/SKILL.md (or your agent's skills folder).
name
draft-openspec-docs
description
Collaborative page-drafting mode for the OpenSpec docs. Builds a scratch plan inside the target page (purpose, structure, numbered draft steps), iterates on it with the user, then drafts one section per approved step and cleans up after itself. Use when a page needs a from-scratch rewrite or a new page is being shaped with the user in the loop.
argument-hint
target page

Draft OpenSpec docs (scratch-plan workflow)

You are shaping a docs page with the user in the loop. The page is planned and reviewed inside the page itself, then drafted one section at a time. Load write-openspec-docs (the style authority) and no-ai-slop before drafting anything.

1. Set up the scratch section

Strip the page to its title and > goal line, then add a working section below them:

md
## Scratch: page plan (delete before publish)

### Purpose

### Structure
  • Purpose: 3-5 dot points. Who the reader is and what they come to look up, what the page covers, what it links out to. Check docs-lab/README.md (the page's goal line) and docs-lab/message-map.md (the questions routed here) before writing it.
  • Structure: a numbered list of the page's sections, one line each naming the section and the shape of its content (table, fence, tree, bullets).
  • Say what the page will do, never what it won't. Plain words and short bullets; the user reads this in their editor.

2. Iterate until the plan is approved

  • Plan edits are cheap; page edits aren't. Reshape the plan as many times as the user asks before drafting.
  • Record every decision in the plan itself, not only in chat. Add a ### Notes list for follow-ups that belong to other pages and product observations found along the way.
  • The user may edit the file directly between turns; their edits are decisions, not drift to revert.
  • Surface one open call at a time, with a recommendation.
Show full SKILL.md (207 more words)Show less

3. Add the draft plan, then draft step by step

Once the structure holds, add a ### Draft plan below the notes: one step per page section, each with an ID and a readable title (**D1. Goal line and intro**), ending with a consolidation step (cross-page updates) and a cleanup step. Then:

  • Wait for the user to call a step ID. Draft exactly that step, into the page above the scratch block.
  • Verify each fact against source before writing it; a cheap grep beats trust. Reference content shows the raw contract (templates, instructions, config) verbatim in fences, linked to the file on GitHub, rather than paraphrasing it.
  • Keep sibling sections on a repeatable sub-structure so the page scans as one system.
  • Mark the step (done) in the plan, report what landed, and name the next step.

4. Consolidation and cleanup

  • Consolidation: update everything that points at the page. The README goal line (verbatim match with the page's > line), the message map, the sync config (website/docs.sync.config.mjs), and any cross-links found by grepping the tree. Run node website/scripts/sync-docs.mjs to validate.
  • Cleanup: delete the scratch block, run the retrievability and glance tests from write-openspec-docs at desktop and narrow widths, and flip the page's message-map row to Answered if its prose landed.

© goern, GPL-3.0. 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 .agents/skills/draft-openspec-docs of goern/forgejo-mcp.

Open the folder on GitHubat commit 64a14bc

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in goern/forgejo-mcp, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Draft Openspec Docs 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.

Draft Openspec Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Draft Openspec Docs this skillgoern/forgejo-mcp1401 repos~815Automated safety check: PassGPL-3.0
Draftanthropics/claude-for-legal9.6k3 repos~2.4kAutomated safety check: PassApache-2.0
Openspec Verify ChangeFission-AI/OpenSpec71k2 repos~4.6kAutomated safety check: PassMIT
OpenSpec Guided OnboardingFission-AI/OpenSpec71k1 repos~4.5kAutomated safety check: PassMIT
Policy Draftinganthropics/claude-for-legal9.6k2 repos~1.4kAutomated safety check: PassApache-2.0
Blog Post Draftingluongnv89/claude-howto42k—~2.1kAutomated safety check: PassMIT

Similar skills

  • Draft

    anthropics/claude-for-legal

    Official

    First draft of a common clinic document — practice-area templates (asylum applications, eviction answers, protective order petitions, demand letters), jurisdiction-aware formatting, explicitly a…

    9.6k GitHub starsUsed in 3 repos~2.4k tokens
    Legal & ComplianceAuto-check passed

  • Openspec Verify Change

    Fission-AI/OpenSpec

    Verify implementation matches OpenSpec change artifacts. An agent skill from Fission-AI/OpenSpec.

    71k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed

  • OpenSpec Guided Onboarding

    Fission-AI/OpenSpec

    Walks you through a complete OpenSpec workflow cycle with narration while doing real work in your codebase.

    71k GitHub starsUsed in 1 repo~4.5k tokens
    Agent WorkflowsAuto-check passed

  • Policy Drafting

    anthropics/claude-for-legal

    Official

    Draft an employment policy with state supplements where law differs across the jurisdictional footprint.

    9.6k GitHub starsUsed in 2 repos~1.4k tokens
    Legal & ComplianceAuto-check passed

  • Blog Post Drafting

    luongnv89/claude-howto

    Guides drafting a blog post from an idea and optional source material: research, brainstorming, outlining and version-tracked drafts, with user approval at each step.

    42k GitHub stars~2.1k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed

  • Blog Post Drafting Workflow

    luongnv89/claude-howto

    Guides a blog post from idea to finished draft: project folder, source research, brainstorming, outline, then iterative drafting, with your approval at set points.

    42k GitHub stars~2.2k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed

More from goern/forgejo-mcp

All 15 skills in this repo

  • Release Openspec

    goern/forgejo-mcp

    A skill your agent uses when releasing OpenSpec: audit merged work and changeset coverage, decide whether a catch-up changeset PR is needed, prepare or resume the Changesets Version Packages PR, cut…

    140 GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed

  • Unified Notifications

    goern/forgejo-mcp

    Fetch and display notifications from both GitHub and Codeberg in a unified markdown view with clickable links.

    140 GitHub stars~802 tokensUpdated yesterday
    Auto-check passed

  • Caveman Compress

    goern/forgejo-mcp

    Compress a memory file such as CLAUDE.md or a todo list into caveman format to save input tokens, keeping a readable backup.

    140 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check: notes

  • Verify Openspec Docs

    goern/forgejo-mcp

    Fact-checks OpenSpec user documentation with a fresh-context subagent that re-runs commands and checks claims against source.

    140 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed

  • Wt Switch Create

    goern/forgejo-mcp

    Create a new worktrunk worktree (optionally in another repo) and switch this session's working directory into it.

    140 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

  • Caveman Help

    goern/forgejo-mcp

    Quick-reference card for caveman modes, skills and commands.

    140 GitHub stars~564 tokensUpdated yesterday
    Auto-check passed

Questions about Draft Openspec Docs

What does Draft Openspec Docs do?

Collaborative page-drafting mode for the OpenSpec docs. An agent skill from goern/forgejo-mcp. Draft Openspec Docs is an agent skill from goern/forgejo-mcp. Collaborative page-drafting mode for the OpenSpec docs.

When should I use Draft Openspec Docs?

Draft Openspec Docs fits situations like: A page needs a from-scratch rewrite; A new page is being shaped with the user in the loop.

How do I install Draft Openspec Docs in Claude Code?

Run `npx skills add goern/forgejo-mcp --skill draft-openspec-docs -a claude-code`. Or copy the skill folder (.agents/skills/draft-openspec-docs in goern/forgejo-mcp) into .claude/skills/draft-openspec-docs in your project. Claude Code loads it when a task matches its description.

How do I install Draft Openspec Docs in Codex?

Run `npx skills add goern/forgejo-mcp --skill draft-openspec-docs -a codex`. Or copy the skill folder (.agents/skills/draft-openspec-docs in goern/forgejo-mcp) into .agents/skills/draft-openspec-docs in your project. Codex loads it when a task matches its description.

Can I use Draft Openspec Docs 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 goern/forgejo-mcp --skill draft-openspec-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/draft-openspec-docs, .gemini/skills/draft-openspec-docs, .github/skills/draft-openspec-docs and .opencode/skills/draft-openspec-docs in your project.

What does Draft Openspec Docs need to run?

Going by SKILL.md and its folder, Draft Openspec Docs needs the command-line tools its instructions call (node).

Does Draft Openspec Docs 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 Draft Openspec Docs 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 Draft Openspec Docs use?

Draft Openspec Docs is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Draft Openspec Docs use?

About 815 tokens (SKILL.md is roughly 3.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 Draft Openspec Docs?

Skills that share tags, products or a category with Draft Openspec Docs: Draft (anthropics/claude-for-legal, 9.6k stars), Openspec Verify Change (Fission-AI/OpenSpec, 71k stars), OpenSpec Guided Onboarding (Fission-AI/OpenSpec, 71k stars) and Policy Drafting (anthropics/claude-for-legal, 9.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Draft Openspec Docs?

goern (a GitHub user) maintains it in goern/forgejo-mcp, which has 140 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 6, 2026.

Source: goern/forgejo-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.