Agent skill

Docs CI

by jh941213 in jh941213/my-cc-harness

Scaffold a docs-as-code CI/CD pipeline + docs drift detection — link check, OpenAPI lint/breaking gate, mermaid validation, docs freshness check, CHANGELOG automation, docs.yaml manifest.

No licenceAuto-check: notesDevelopment

Install Docs CI

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

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

GitHub CLI
$ gh skill install jh941213/my-cc-harness docs-ci --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-ci .claude/skills/docs-ci && 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-ci
GitHub stars
126
Token cost
~989 tokens
SKILL.md length
357 words
Files
3
Skills in repo
62
Repo updated
First seen
Licence
None found

At a glance

Scaffold a docs-as-code CI/CD pipeline + docs drift detection — link check, OpenAPI lint/breaking gate, mermaid validation, docs freshness check, CHANGELOG automation, docs.yaml manifest.

  • Works in 6 steps: Diagnose the project: which docs/specs… → Install only checks that match what… → Create/update docs/docs.yaml (scan… → …
  • Installing docs CI/pipelines
  • SKILL.md covers Input, The docs.yaml manifest (the…, Checks it installs (pick per… and Procedure, plus 2 more sections
  • Runs Shell scripts from its folder; calls git and bash

What it does

Docs CI is an agent skill from jh941213/my-cc-harness. Scaffold a docs-as-code CI/CD pipeline + docs drift detection — link check, OpenAPI lint/breaking gate, mermaid validation, docs freshness check, CHANGELOG automation, docs.yaml manifest. Use when installing docs CI/pipelines, detecting docs drift/freshness, docs sync automation, link checks, changelog automation. Writing doc content → docs-architecture/interfaces/manuals; not for the app's own deploy pipeline

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `templates/check-docs-freshness.sh` and `templates/docs-ci.yml`).

It sits in Development, covering CI/CD, GitOps and OpenAPI specifications. It works with OpenAPI, Mermaid and Git.

When your agent uses it

  • Installing docs CI/pipelines
  • Detecting docs drift/freshness
  • Docs sync automation
  • Changelog automation

Example prompts

  • “/docs-ci”

Requirements

  • A Bash shell
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Glob, Grep, Bash

Workflow steps

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

  1. Diagnose the project: which docs/specs exist (docs/, openapi.*, mermaid blocks, docs site generator)
  2. Install only checks that match what exists — no spectral gate for a project without OpenAPI
  3. Create/update docs/docs.yaml (scan existing docs to draft covers — include comments so users can refine)
  4. Create {project}/scripts/check-docs-freshness.sh — copy the template templates/check-docs-freshness.sh into the target project's…
  5. Create .github/workflows/docs-ci.yml (only the needed jobs from templates/docs-ci.yml) — the trigger branch is fixed to main, so adjust to…
  6. Run once locally and report: bash scripts/check-docs-freshness.sh

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

    Ships script files (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • git
    • bash

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

  • Network

    No URLs in SKILL.md. Its commands use git, 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 CI loads about 989 tokens when it runs. Until then it costs about 105 tokens; SKILL.md has 357 words of instructions outside code blocks.

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

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 357 words (~989 tokens).

“Builds the pipeline that guards the docs, not the docs themselves. Output: GitHub Actions workflow + drift detection script + the docs/docs.yaml manifest convention.”

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

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files in skills_en/docs-ci of jh941213/my-cc-harness.

  • SKILL.md
  • templates/check-docs-freshness.sh
  • templates/docs-ci.yml

Open the folder on GitHubat commit e9210e2

Compare with similar skills

Docs CI 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 CI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs CI this skilljh941213/my-cc-harness126—~989Automated safety check: NotesNone
VibexRaja0sama/vibex388—~7.8kAutomated safety check: PassMIT
Generating Documentationancoleman/ai-design-components526—~3kAutomated safety check: PassMIT
Update Dependenciesalorence/django-modern-rpc111—~1.3kAutomated safety check: PassMIT
Lark Whiteboardappleweiping/WEIPING_WIKI119—~1.2kAutomated safety check: PassMIT
Worktrunk Release Workflowmax-sixty/worktrunk9k—~6.9kAutomated safety check: PassCustom licence

Similar skills

  • Vibex

    Raja0sama/vibex

    Diagrams and checkable docs from a codebase. An agent skill from Raja0sama/vibex.

    388 GitHub stars~7.8k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Generating Documentation

    ancoleman/ai-design-components

    Generate comprehensive technical documentation including API docs (OpenAPI/Swagger), code documentation (TypeDoc/Sphinx), documentation sites (Docusaurus/MkDocs), Architecture Decision Records…

    526 GitHub stars~3k tokensUpdated 10 mo ago
    DevelopmentAuto-check passed
  • Update Dependencies

    alorence/django-modern-rpc

    Routine update of all project dependencies — uv itself, uv.lock (all groups), tool versions pinned in GitHub workflows and .pre-commit-config.yaml (uv, ruff, mypy...), and SHA-pinned GitHub Actions.

    111 GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Lark Whiteboard

    appleweiping/WEIPING_WIKI

    飞书画板:查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用 DSL(转成 OpenAPI 格式)、PlantUML/Mermaid 格式更新画板内容。

    119 GitHub stars~1.2k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Worktrunk Release Workflow

    max-sixty/worktrunk

    Walks a maintainer through cutting a Worktrunk release: sync the release branch, pass two test gates, review the changes, then publish.

    9k GitHub stars~6.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Coffee GB Release

    trekawek/coffee-gb

    Releases the current Coffee GB Maven snapshot through the GitHub Maven release workflow, then verifies and curates the tag and GitHub release.

    1.2k GitHub stars~1.4k tokensUpdated 7 days ago
    DevelopmentAuto-check passed

More from jh941213/my-cc-harness

All 62 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 20 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 10 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
  • Async Python Patterns

    jh941213/my-cc-harness

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

    126 GitHub starsUsed in 14 repos~4.7k tokens
    Auto-check passed
  • Python Testing Patterns

    jh941213/my-cc-harness

    Implement comprehensive testing strategies with pytest, fixtures, mocking, and test-driven development.

    126 GitHub starsUsed in 17 repos~5.4k tokens
    Auto-check passed

Questions about Docs CI

What does Docs CI do?

Scaffold a docs-as-code CI/CD pipeline + docs drift detection — link check, OpenAPI lint/breaking gate, mermaid validation, docs freshness check, CHANGELOG automation, docs.yaml manifest. Docs CI is an agent skill from jh941213/my-cc-harness.yaml manifest.

When should I use Docs CI?

Docs CI fits situations like: installing docs CI/pipelines; detecting docs drift/freshness; docs sync automation; changelog automation.

How do I install Docs CI in Claude Code?

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

How do I install Docs CI in Codex?

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

Can I use Docs CI 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-ci -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-ci, .gemini/skills/docs-ci, .github/skills/docs-ci and .opencode/skills/docs-ci in your project.

What does Docs CI need to run?

Going by SKILL.md and its folder, Docs CI needs a shell for the scripts in its folder and the command-line tools its instructions call (git and bash). Our summary lists: A Bash shell. Its frontmatter pre-approves these tools: Read, Write, Edit, Glob, Grep, Bash.

Does Docs CI access the network?

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

Is Docs CI 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 CI use?

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

How many tokens does Docs CI use?

About 989 tokens (SKILL.md is roughly 4k 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 CI?

Skills that share tags, products or a category with Docs CI: Vibex (Raja0sama/vibex, 388 stars), Generating Documentation (ancoleman/ai-design-components, 526 stars), Update Dependencies (alorence/django-modern-rpc, 111 stars) and Lark Whiteboard (appleweiping/WEIPING_WIKI, 119 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs CI?

jh941213 (a GitHub user) maintains it in jh941213/my-cc-harness, which has 126 GitHub stars. The repository holds 62 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.