Agent skill

Maintainer Docs Site Authoring

by devcodex-labs in devcodex-labs/devcodex

维护者/贡献者开发站点文档写作 Owner — 本地开发、贡献、测试、发版 runbook、internals/ADR;与用户使用站不等价;写文档时经 DocsAudienceIntent 路由。

AGPL-3.0Auto-check passedDevOps & Cloud

Install Maintainer Docs Site Authoring

skills CLI
$ npx skills add devcodex-labs/devcodex --skill maintainer-docs-site-authoring -a claude-code

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

GitHub CLI
$ gh skill install devcodex-labs/devcodex maintainer-docs-site-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/devcodex-labs/devcodex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/content/skills/maintainer-docs-site-authoring .claude/skills/maintainer-docs-site-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
maintainer-docs-site-authoring
GitHub stars
439
Token cost
~489 tokens
SKILL.md length
125 words
Files
3
Skills in repo
70
Repo updated
First seen
Licence
AGPL-3.0

At a glance

维护者/贡献者开发站点文档写作 Owner — 本地开发、贡献、测试、发版 runbook、internals/ADR;与用户使用站不等价;写文档时经 DocsAudienceIntent 路由。

  • Works in 7 steps: 仓库如何检出与分支约定 → 环境与依赖 → 常用开发/测试/构建命令 → …
  • Tasks that involve Static sites and blogs
  • SKILL.md covers 职责, 触发条件, 文档契约 and 主路径章节(推荐), plus 4 more sections
  • Calls npm

What it does

Maintainer Docs Site Authoring is an agent skill from devcodex-labs/devcodex. 维护者/贡献者开发站点文档写作 Owner — 本地开发、贡献、测试、发版 runbook、internals/ADR;与用户使用站不等价;写文档时经 DocsAudienceIntent 路由。

Its SKILL.md is about 490 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `CSD-maintainer-docs-site.v1.json` and `intent.json`).

It sits in DevOps & Cloud, covering Static sites and blogs, Architecture decision records and Runbooks and postmortems. The repository describes itself as: Intent-driven AI coding workflow runtime for consistent context, skills, approvals, validation, and handoffs across six AI coding hosts. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Static sites and blogs
  • Tasks that involve Architecture decision records
  • Tasks that involve Runbooks and postmortems

Example prompts

  • “/maintainer-docs-site-authoring”

Workflow steps

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

  1. 仓库如何检出与分支约定
  2. 环境与依赖
  3. 常用开发/测试/构建命令
  4. 贡献流程(PR、检查项)
  5. 发版/runbook(若适用)
  6. 文档与规范如何改、如何验证
  7. 可选:架构/ADR 索引(后置或独立页)

What it can do on your machine

Read from SKILL.md and the folder at commit 1dd4525. 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:

    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use npm, 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

Maintainer Docs Site Authoring loads about 489 tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 125 words of instructions outside code blocks.

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

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 devcodex-labs/devcodex at commit 1dd4525, republished under its AGPL-3.0 licence (© devcodex-labs). 125 words, ~489 tokens.

Download SKILL.mdSave it as .claude/skills/maintainer-docs-site-authoring/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
maintainer-docs-site-authoring
description
维护者/贡献者开发站点文档写作 Owner — 本地开发、贡献、测试、发版 runbook、internals/ADR;与用户使用站不等价;写文档时经 DocsAudienceIntent 路由。

Maintainer Docs Site Authoring Skill

职责

当任务主受众是维护本仓库 / 贡献代码的人时,本 Skill 是写作入口。

成功标准:读者能 clone → 环境 → 开发命令 → 测试 → 贡献/发版 → 改文档。
禁止把本 Skill 当作用户安装/接入手册。

触发条件

场景是否触发
docsAudience=maintainer-dev(DocsAudienceIntentGate)必须
维护者开发站、contributing、本地开发、发版 runbook、internals、ADR必须
用户使用/安装/quick start/公开用户站N/A → user-manual-authoring
仅说「写文档站」且 ambiguousN/A → 阻断消歧,禁止开写

文档契约

字段要求
primaryAudience维护者 / 贡献者
docsSurface默认 maintainer(可含 contributing/internals)
maintainerJourneyclone → env → dev → test → contribute/release → docs
executableCommands至少给出可复制的安装依赖与测试/构建命令(与 package 一致或标明 N/A)
repoMap关键目录/包职责(简短,不作用户产品叙事)
developerInfoPlacement主叙事即开发;用户安装路径不得抢首屏
consumerMapCONTRIBUTING、docs/dev、website maintainer 分区、Profile 脚本说明等

主路径章节(推荐)

  1. 仓库如何检出与分支约定
  2. 环境与依赖
  3. 常用开发/测试/构建命令
  4. 贡献流程(PR、检查项)
  5. 发版/runbook(若适用)
  6. 文档与规范如何改、如何验证
  7. 可选:架构/ADR 索引(后置或独立页)

禁止

  • 禁止冒充最终用户使用手册(无 install-as-user 主路径而写「适合谁使用本产品」首屏)。
  • 禁止用产品广告替代 clone/test 命令。
  • 禁止在单任务内同时交付用户站主路径并宣称用户站完成(多受众须拆任务)。
  • CONTRIBUTING 文件可选;本 Skill 提供结构,不强制每个项目生成文件。

完成前自检

  • 模型检查维护者是否能按文档完成开发任务,再将绑定正文摘要、理由和来源引用的 DocsContentReviewV1 交给 classifyDocsAudienceDriftSample('maintainer-dev', body, review);未审查为 unverified,不依赖 clone/test 等词判定通过。
  • 与 package.json scripts / README 开发段不矛盾。
  • 审查:audit-document 维护者站维;用户侧污染检查不适用于主路径。

与其他 Skill

  • user-manual-authoring:用户站;受众正交。
  • dev-docs:架构/API 技术文可联动;不替代本 Skill 的维护者站入口。
  • document-sync:consumerMap 标注 audience=maintainer-dev。
  • DocsAudienceIntentGate:模型语义判定;scripts/lib/docs-audience-intent.js 仅验证结构和当前正文摘要。协议测试不能替代内容审查。

验证

bash
npm run test:docs-audience

© devcodex-labs, AGPL-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

SKILL.md and 2 other files in content/skills/maintainer-docs-site-authoring of devcodex-labs/devcodex.

  • SKILL.md
  • CSD-maintainer-docs-site.v1.json
  • intent.json

Open the folder on GitHubat commit 1dd4525

Compare with similar skills

Maintainer Docs Site 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.

Maintainer Docs Site Authoring compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Maintainer Docs Site Authoring this skilldevcodex-labs/devcodex439—~489Automated safety check: PassAGPL-3.0
Obsidian WriterAtmosphere/atmosphere3.8k—~2.6kAutomated safety check: PassApache-2.0
Review A Designinkeep/open-knowledge4.4k—~3.7kAutomated safety check: PassGPL-3.0
Architecturenteract/nteract178—~497Automated safety check: PassBSD-3-Clause
Create Docavibebuilder/claude-prime120—~812Automated safety check: PassMIT
Confluence Docsbybren-llc/safe-agentic-workflow421—~1.4kAutomated safety check: PassMIT

Similar skills

  • Obsidian Writer

    Atmosphere/atmosphere

    Write well-formatted notes to the atmosphere-vault Obsidian knowledge base.

    3.8k GitHub stars~2.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Review A Design

    inkeep/open-knowledge

    Reviews whether a design is SOUND — solving the right problem, derived from its stated goals and constraints — and emits ranked, evidence-backed findings, not edits.

    4.4k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Architecture

    nteract/nteract

    Architecture and documentation framing for cross-cutting repo decisions, docs taxonomy placement, ADRs, memos, PRDs, implementation plans, audits, measurements, runbooks, and source-grounded…

    178 GitHub stars~497 tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Create Doc

    avibebuilder/claude-prime

    A skill your agent uses when the user wants to save knowledge as a file so others don't have to rediscover it — "turn this into a doc", "write this up", "document how X works", "we figured this out…

    120 GitHub stars~812 tokensUpdated 4 mo ago
    DevOps & CloudAuto-check passed
  • Confluence Docs

    bybren-llc/safe-agentic-workflow

    Documentation templates for ADRs, runbooks, and architecture docs.

    421 GitHub stars~1.4k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Gh Doc Author

    caarlos0/dotfiles

    Author and revise clear GitHub internal documentation, including design docs, proposals, decision records, runbooks, status updates, and handoffs.

    220 GitHub stars~2.2k tokensUpdated today
    DevOps & CloudAuto-check passed

More from devcodex-labs/devcodex

All 70 skills in this repo
  • Accessibility I18n

    devcodex-labs/devcodex

    无障碍与国际化专家 Owner — 当任务涉及可访问性、键盘操作、焦点、屏幕阅读器、ARIA、语言地区、本地化、RTL、翻译资源、用户可见文案或多语言文档时使用;要求把包容性体验和本地化验证绑定到真实用户路径。

    439 GitHub stars~718 tokensUpdated 20 days ago
    Auto-check passed
  • AI Agent System Architecture

    devcodex-labs/devcodex

    AI Agent 系统架构专家 Owner — 当任务涉及 Agent 路由、工具调用、上下文管理、记忆、状态机、权限、人机协作、可观测性、回放验证或模型辅助治理时使用;要求把 Agent 行为设计成可解释、可恢复、可审计。

    439 GitHub stars~2.4k tokensUpdated 20 days ago
    Auto-check passed
  • API Contract Architecture

    devcodex-labs/devcodex

    API 契约架构专家 Owner — 当任务涉及 public API、HTTP/SDK/CLI 契约、版本兼容、错误模型、分页过滤、幂等、Schema、类型、迁移或消费者影响时使用;要求先冻结消费者契约,再设计实现与验证。

    439 GitHub stars~865 tokensUpdated 20 days ago
    Auto-check passed
  • Architecture Design

    devcodex-labs/devcodex

    架构设计文档编排 Owner — 当用户要求架构设计、系统设计、技术架构或可指导开发、Review 与任务拆分的完整方案时使用;要求从业务流程反推节点、状态、数据、一致性、异常补偿、ADR 与实施任务。

    439 GitHub stars~1.1k tokensUpdated 20 days ago
    Auto-check passed
  • Audit Common

    devcodex-labs/devcodex

    审查公共维度 G0~G5 + Profile Freshness Check — 所有 audit 子类型必先执行的基础维度层

    439 GitHub stars~4.1k tokensUpdated 20 days ago
    Auto-check passed
  • Audit Session

    devcodex-labs/devcodex

    审计工作流的跨会话状态机 — 在 <audit-root/.audit-state/<session-id.json 持久化轮次/发现项/收敛状态,支持 Token 中断后精准恢复

    439 GitHub stars~1.8k tokensUpdated 20 days ago
    Auto-check passed

Questions about Maintainer Docs Site Authoring

What does Maintainer Docs Site Authoring do?

维护者/贡献者开发站点文档写作 Owner — 本地开发、贡献、测试、发版 runbook、internals/ADR;与用户使用站不等价;写文档时经 DocsAudienceIntent 路由。. Maintainer Docs Site Authoring is an agent skill from devcodex-labs/devcodex.

When should I use Maintainer Docs Site Authoring?

Maintainer Docs Site Authoring fits situations like: tasks that involve Static sites and blogs; tasks that involve Architecture decision records; tasks that involve Runbooks and postmortems.

How do I install Maintainer Docs Site Authoring in Claude Code?

Run `npx skills add devcodex-labs/devcodex --skill maintainer-docs-site-authoring -a claude-code`. Or copy the skill folder (content/skills/maintainer-docs-site-authoring in devcodex-labs/devcodex) into .claude/skills/maintainer-docs-site-authoring in your project. Claude Code loads it when a task matches its description.

How do I install Maintainer Docs Site Authoring in Codex?

Run `npx skills add devcodex-labs/devcodex --skill maintainer-docs-site-authoring -a codex`. Or copy the skill folder (content/skills/maintainer-docs-site-authoring in devcodex-labs/devcodex) into .agents/skills/maintainer-docs-site-authoring in your project. Codex loads it when a task matches its description.

Can I use Maintainer Docs Site 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 devcodex-labs/devcodex --skill maintainer-docs-site-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/maintainer-docs-site-authoring, .gemini/skills/maintainer-docs-site-authoring, .github/skills/maintainer-docs-site-authoring and .opencode/skills/maintainer-docs-site-authoring in your project.

What does Maintainer Docs Site Authoring need to run?

Going by SKILL.md and its folder, Maintainer Docs Site Authoring needs the command-line tools its instructions call (npm).

Does Maintainer Docs Site Authoring access the network?

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

Is Maintainer Docs Site 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 Maintainer Docs Site Authoring use?

Maintainer Docs Site Authoring is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Maintainer Docs Site Authoring use?

About 489 tokens (SKILL.md is roughly 2k 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 Maintainer Docs Site Authoring?

Skills that share tags, products or a category with Maintainer Docs Site Authoring: Obsidian Writer (Atmosphere/atmosphere, 3.8k stars), Review A Design (inkeep/open-knowledge, 4.4k stars), Architecture (nteract/nteract, 178 stars) and Create Doc (avibebuilder/claude-prime, 120 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Maintainer Docs Site Authoring?

devcodex-labs (a GitHub organization) maintains it in devcodex-labs/devcodex, which has 439 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on September 17, 2026.

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