Maintainer Docs Site Authoring logo

Maintainer Docs Site Authoring

Organization
devcodex-labs
maintainer-docs-site-authoring

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

Overview

Publisherdevcodex-labs
Repositorydevcodex
Skill namemaintainer-docs-site-authoring
Stars
433
Forks
44
Bundled files
2
LicenseAGPL-3.0
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 2 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by devcodex-labs on GitHub. Read the source before you install it.

Installation

Install the Maintainer Docs Site Authoring AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/devcodex-labs/devcodex/tree/main/content/skills/maintainer-docs-site-authoring
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/devcodex-labs/devcodex.git /tmp/devcodex
mkdir -p .claude/skills
cp -r /tmp/devcodex/content/skills/maintainer-docs-site-authoring .claude/skills/maintainer-docs-site-authoring
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Maintainer Docs Site Authoring in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Maintainer Docs Site Authoring on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Maintainer Docs Site Authoring is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

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

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Maintainer Docs Site Authoring AI skill do?

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

Why use Maintainer Docs Site Authoring on TypingMind?

Because you install it once and use it with any model. Maintainer Docs Site Authoring is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Maintainer Docs Site Authoring in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/devcodex-labs/devcodex/tree/main/content/skills/maintainer-docs-site-authoring. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Maintainer Docs Site Authoring?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Maintainer Docs Site Authoring?

As many as you like. As long as a model supports skills, you can use Maintainer Docs Site Authoring with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Maintainer Docs Site Authoring AI skill free?

Yes. It is published on GitHub by devcodex-labs under the AGPL-3.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇