Agent skill

Docs Interfaces

by jh941213 in jh941213/my-cc-harness

Generate interface/API docs — OpenAPI 3.1/AsyncAPI 3.0 specs, API topology diagrams, interface flow (sequence) diagrams, API changelog.

No licenceAuto-check: notesBackend & APIs

Install Docs Interfaces

skills CLI
$ npx skills add jh941213/my-cc-harness --skill docs-interfaces -a claude-code

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

GitHub CLI
$ gh skill install jh941213/my-cc-harness docs-interfaces --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/jh941213/my-cc-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills_en/docs-interfaces .claude/skills/docs-interfaces && 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
docs-interfaces
GitHub stars
126
Token cost
~863 tokens
SKILL.md length
330 words
Files
1
Skills in repo
66
Repo updated
First seen
Licence
None found

At a glance

Generate interface/API docs — OpenAPI 3.1/AsyncAPI 3.0 specs, API topology diagrams, interface flow (sequence) diagrams, API changelog.

  • Works in 5 steps: Write from actual routes/schemas read… → operationId required, group resources… → Examples must be real working values → …
  • Writing API docs/specs (OpenAPI
  • SKILL.md covers Input, Artifact map, Spec-first vs code-first and OpenAPI rules, plus 4 more sections
  • Calls npx

What it does

Docs Interfaces is an agent skill from jh941213/my-cc-harness. Generate interface/API docs — OpenAPI 3.1/AsyncAPI 3.0 specs, API topology diagrams, interface flow (sequence) diagrams, API changelog. Use when writing API docs/specs (OpenAPI, swagger, AsyncAPI), interface/API topology diagrams, endpoint docs, API changelogs. Whole-system diagrams → docs-architecture; user manuals → docs-manuals; API design principles themselves → api-design-principles

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

It sits in Backend & APIs, covering Diagrams, OpenAPI specifications and Changelog and release notes. It works with OpenAPI.

When your agent uses it

  • Writing API docs/specs (OpenAPI
  • Interface/API topology diagrams

Example prompts

  • “/docs-interfaces”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Glob, Grep, Bash

Workflow steps

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

  1. Write from actual routes/schemas read from code — no guessing. Mark unverifiable fields with TODO comments
  2. operationId required, group resources with tags, include 4xx/5xx responses
  3. Examples must be real working values
  4. Declare auth schemes (securitySchemes)
  5. Don't force event-driven interfaces (queues, websockets, webhooks) into OpenAPI — split into AsyncAPI

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Glob
    • Grep
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    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

Docs Interfaces loads about 863 tokens when it runs. Until then it costs about 102 tokens; SKILL.md has 330 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Glob, Grep, Bash

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 330 words (~863 tokens).

“Documents contracts between systems. The spec in Git is the single source of truth (docs-as-code).”

— opening of SKILL.md by jh941213
name
docs-interfaces
allowed-tools
Read, Write, Edit, Glob, Grep, Bash
user-invocable
true
disable-model-invocation
false

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills_en/docs-interfaces of jh941213/my-cc-harness.

Open the folder on GitHubat commit e9210e2

Compare with similar skills

Docs Interfaces 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.

Docs Interfaces compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Interfaces this skilljh941213/my-cc-harness126—~863Automated safety check: NotesNone
Documentationaiskillstore/marketplace4301 repos~2.7kAutomated safety check: PassNone
OpenAPI Spec Generationwshobson/agents40k9 repos~511Automated safety check: PassMIT
Technical Writingcitypaul/.dotfiles739—~2.5kAutomated safety check: PassMIT
API Documentation Generatorluongnv89/claude-howto42k—~429Automated safety check: PassMIT
Agentic Workflows API Documentation Lungoagntcy/coffeeAgntcy112—~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • Documentation

    aiskillstore/marketplace

    Comprehensive documentation specialist covering API documentation, technical writing, design documentation, migration guides, and changelog generation.

    430 GitHub starsUsed in 1 repo~2.7k tokens
    DevelopmentAuto-check passed
  • Create, validate and maintain OpenAPI 3.1 specs for REST APIs, whether designed first or generated from existing code, and use them for docs and client SDKs.

    40k GitHub starsUsed in 9 repos~511 tokens
    Backend & APIsAuto-check passed
  • Technical Writing

    citypaul/.dotfiles

    Writing developer-facing prose that can be skimmed first and trusted enough to finish — READMEs, guides, tutorials, reference docs, proposals, PR descriptions, release notes.

    739 GitHub stars~2.5k tokensUpdated 4 days ago
    Writing & ContentAuto-check passed
  • API Documentation Generator

    luongnv89/claude-howto

    Generate comprehensive, accurate API documentation from source code. Use when creating or updating API documentation, generating OpenAPI specs, or when users…

    42k GitHub stars~429 tokensUpdated 7 days ago
    DevelopmentAuto-check passed
  • Authors and maintains the human-facing Agentic Workflows API documentation for the lungo subproject at coffeeAGNTCY/coffeeagents/lungo/docs/workflow-instanceapi.md.

    112 GitHub stars~2.6k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Ukrainian-language skill for writing API documentation from source code: OpenAPI specs, endpoint pages, SDK examples, integration and authentication guides and error code references.

    42k GitHub stars~375 tokensUpdated 7 days ago
    DevelopmentAuto-check passed

More from jh941213/my-cc-harness

All 66 skills in this repo
  • API Design Principles

    jh941213/my-cc-harness

    REST 및 GraphQL API 설계 원칙 가이드. An agent skill from jh941213/my-cc-harness.

    126 GitHub starsUsed in 19 repos~3.4k tokens
    Auto-check passed
  • Tailwind Design System

    jh941213/my-cc-harness

    Build scalable design systems with Tailwind CSS, design tokens, component libraries, and responsive patterns.

    126 GitHub starsUsed in 9 repos~4.7k tokens
    Auto-check passed
  • Docs Architecture

    jh941213/my-cc-harness

    Generate/update architecture docs — ARCHITECTURE.md (codemap), architecture diagrams (C4 mermaid), ADRs (MADR), data model ERD.

    126 GitHub stars~923 tokensUpdated 2 mo ago
    Auto-check: notes
  • Auto Memory

    jh941213/my-cc-harness

    A skill your agent uses when starting substantial work in a repo (implementation, fixes, deploys, debugging), when first exploring a new repo, or when finishing work that produced reusable knowledge.

    126 GitHub stars~890 tokensUpdated 2 mo ago
    Auto-check passed
  • Autodev

    jh941213/my-cc-harness

    Ralph Loop based autonomous development loop. An agent skill from jh941213/my-cc-harness.

    126 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check: notes
  • Async Python Patterns

    jh941213/my-cc-harness

    Python asyncio 및 async/await 패턴 가이드. An agent skill from jh941213/my-cc-harness.

    126 GitHub starsUsed in 13 repos~4.7k tokens
    Auto-check passed

Works with

Questions about Docs Interfaces

What does Docs Interfaces do?

Generate interface/API docs — OpenAPI 3.1/AsyncAPI 3.0 specs, API topology diagrams, interface flow (sequence) diagrams, API changelog. Docs Interfaces is an agent skill from jh941213/my-cc-harness.0 specs, API topology diagrams, interface flow (sequence) diagrams, API changelog.

When should I use Docs Interfaces?

Docs Interfaces fits situations like: writing API docs/specs (OpenAPI; interface/API topology diagrams.

How do I install Docs Interfaces in Claude Code?

Run `npx skills add jh941213/my-cc-harness --skill docs-interfaces -a claude-code`. Or copy the skill folder (skills_en/docs-interfaces in jh941213/my-cc-harness) into .claude/skills/docs-interfaces in your project. Claude Code loads it when a task matches its description.

How do I install Docs Interfaces in Codex?

Run `npx skills add jh941213/my-cc-harness --skill docs-interfaces -a codex`. Or copy the skill folder (skills_en/docs-interfaces in jh941213/my-cc-harness) into .agents/skills/docs-interfaces in your project. Codex loads it when a task matches its description.

Can I use Docs Interfaces 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 jh941213/my-cc-harness --skill docs-interfaces -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docs-interfaces, .gemini/skills/docs-interfaces, .github/skills/docs-interfaces and .opencode/skills/docs-interfaces in your project.

What does Docs Interfaces need to run?

Going by SKILL.md and its folder, Docs Interfaces needs the command-line tools its instructions call (npx). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Read, Write, Edit, Glob, Grep, Bash.

Does Docs Interfaces access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Docs Interfaces safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Docs Interfaces use?

No licence was found for Docs Interfaces or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Docs Interfaces use?

About 863 tokens (SKILL.md is roughly 3.5k 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 Docs Interfaces?

Skills that share tags, products or a category with Docs Interfaces: Documentation (aiskillstore/marketplace, 430 stars), OpenAPI Spec Generation (wshobson/agents, 40k stars), Technical Writing (citypaul/.dotfiles, 739 stars) and API Documentation Generator (luongnv89/claude-howto, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Interfaces?

jh941213 (a GitHub user) maintains it in jh941213/my-cc-harness, which has 126 GitHub stars. The repository holds 66 skills in this directory. The repository was last updated on August 3, 2026.

Source: jh941213/my-cc-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.