Agent skill

Gen Docs

by MoonshotAI in MoonshotAI/kimi-code

Update Kimi Code CLI user documentation after meaningful code changes that affect product behavior or user experience.

MITAuto-check passedDevelopment

Install Gen Docs

skills CLI
$ npx skills add MoonshotAI/kimi-code --skill gen-docs -a claude-code

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

GitHub CLI
$ gh skill install MoonshotAI/kimi-code gen-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/MoonshotAI/kimi-code.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/gen-docs .claude/skills/gen-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
gen-docs
GitHub stars
7.8k
Token cost
~1.2k tokens
SKILL.md length
556 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Update Kimi Code CLI user documentation after meaningful code changes that affect product behavior or user experience.

  • Works in 5 steps: Inspect changes → Understand user-facing impact → Sync English changelog → …
  • Tasks that involve UX design
  • SKILL.md covers Overview, Prerequisites, Workflow and Rules and conventions, plus 1 more section
  • Calls git and node

What it does

Gen Docs is an agent skill from MoonshotAI/kimi-code. Update Kimi Code CLI user documentation after meaningful code changes that affect product behavior or user experience.

Its SKILL.md is about 1.2k 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 Development, covering UX design. It works with Kimi. The repository describes itself as: Kimi Code CLI — The Starting Point for Next-Gen Agents. The licence is MIT.

When your agent uses it

  • Tasks that involve UX design

Example prompts

  • “/gen-docs”

Requirements

  • A credential in YOUR_API_KEY

Workflow steps

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

  1. Inspect changes
  2. Understand user-facing impact
  3. Sync English changelog
  4. Update user docs
  5. Sync bilingual content

What it can do on your machine

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

    • git
    • node

    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

Gen Docs loads about 1.2k tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 556 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
~1.2k

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 MoonshotAI/kimi-code at commit 0f052fe, republished under its MIT licence (© MoonshotAI). 556 words, ~1,188 tokens.

Download SKILL.mdSave it as .claude/skills/gen-docs/SKILL.md (or your agent's skills folder).
name
gen-docs
description
Update Kimi Code CLI user documentation after meaningful code changes that affect product behavior or user experience.

Gen Docs

Overview

This repository maintains bilingual user documentation under docs/. docs/en/ and docs/zh/ are mirrored pairs for most pages; update both in the same change. Changelog is the exception — English is the source, and Chinese is translated from English.

Use this skill to update the corresponding documentation whenever the codebase has changes that affect product behavior or user experience.

For a full pre-release audit of all pages (detecting hallucinations and coverage gaps), use the audit-docs skill instead.

Prerequisites

This skill depends on the following being in place. If any are missing, stop and report to the user before continuing:

  • docs/ directory with docs/zh/, docs/en/, and docs/.vitepress/config.ts set up (VitePress site).
  • docs/AGENTS.md style guide — defines source-of-truth rules, terminology table, typography, and writing style.
  • docs/scripts/sync-changelog.mjs — auto-syncs root CHANGELOG.md to docs/en/release-notes/changelog.md.
  • translate-docs skill in .agents/skills/ — handles bilingual synchronization.

Workflow

  1. Inspect changes

    • git log main..HEAD --oneline — commits on the current branch
    • git diff main..HEAD --stat — file-level scope
    • ls .changeset/*.md (excluding README.md) — pending changeset entries
    • Read CHANGELOG.md and any subpackage packages/*/CHANGELOG.md for already-recorded entries.
  2. Understand user-facing impact

    For each change, read the actual implementation when needed; do not infer behavior from commit messages or PR titles alone. Skip:

    • Internal refactors with no externally visible behavior change
    • Tests, CI, type-only changes
    • Tooling / build-system changes that do not change how users invoke the CLI

    If after the scan you conclude there is no user-facing impact, say so and stop.

  3. Sync English changelog

    Run:

    bash
    node docs/scripts/sync-changelog.mjs

    This updates docs/en/release-notes/changelog.md from the root CHANGELOG.md. Never edit the docs changelog by hand.

  4. Update user docs

    Following the rules in docs/AGENTS.md, edit the affected pages in whichever locale you are working in, then sync the mirror. Match terminology with the term table in docs/AGENTS.md and the existing wording in surrounding pages.

    Cover all relevant sections:

    • Guides (getting-started, use cases, interaction, sessions, IDE integration)
    • Customization (skills, agents, MCP, hooks, plugins, etc.)
    • Configuration (config files, env vars, providers, data locations)
    • Reference (CLI subcommands, slash commands, keyboard shortcuts)
    • Release notes (docs/zh/release-notes/breaking-changes.md if a breaking change is involved)
  5. Sync bilingual content

    Invoke the translate-docs skill. It will:

    • Sync updated non-changelog pages between docs/en/ and docs/zh/
    • Translate the English changelog → Chinese under docs/zh/release-notes/changelog.md
Show full SKILL.md (195 more words)Show less

Rules and conventions

  • Locale sync: Non-changelog pages stay mirrored between docs/en/ and docs/zh/. Changelog flows English → Chinese.
  • Terminology: Use the term table in docs/AGENTS.md exactly. Do not invent new translations or use synonyms.
  • Scope discipline: Only update sections affected by the recent changes. Do not opportunistically rewrite unrelated docs.
  • Public examples: Never write real internal endpoints, key names, account names, or service names into docs. Use neutral placeholders such as https://api.example.com/v1, https://registry.example.com/v1/models/api.json, example.test, and YOUR_API_KEY.
  • Breaking changes: If any change is breaking, also update docs/en/release-notes/breaking-changes.md (under ## Unreleased) with **Affected** + **Migration** subsections, and mirror it in docs/zh/release-notes/breaking-changes.md.
  • Do not edit auto-synced files: docs/en/release-notes/changelog.md is regenerated by the sync script; any manual edit will be overwritten.

Common mistakes

  • Describing what code changed instead of what the user can now do (or can no longer do).
  • Adding a new section heading per feature instead of weaving the change into existing prose.
  • Updating only one locale and leaving its mirror stale.
  • Editing only the mirror to fix wording that should be corrected in the locale you changed first.
  • Inventing new terminology that drifts from the docs/AGENTS.md term table.
  • Using real internal values in examples instead of neutral example placeholders.

© MoonshotAI, MIT. 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/gen-docs of MoonshotAI/kimi-code.

Open the folder on GitHubat commit 0f052fe

Compare with similar skills

Gen 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.

Gen Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gen Docs this skillMoonshotAI/kimi-code7.8k—~1.2kAutomated safety check: PassMIT
Extension Reviewervicinaehq/extensions155—~1.1kAutomated safety check: PassNone
Ostackmr-daedalium/ostack-saas114—~6.1kAutomated safety check: NotesMIT
Expertreviewjtenniswood/esphome-media-player234—~1.9kAutomated safety check: PassCustom licence
Reviewmag123c/toktrack193—~1.2kAutomated safety check: PassMIT
Loft Design PrototypingYeachan-Heo/oh-my-claudecode40k—~1.4kAutomated safety check: PassMIT

Similar skills

  • Extension Reviewer

    vicinaehq/extensions

    Review Vicinae extensions for publication in the official store, or prepare an extension for submission.

    155 GitHub stars~1.1k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Ostack

    mr-daedalium/ostack-saas

    Fast headless browser for QA testing and site dogfooding. An agent skill from mr-daedalium/ostack-saas.

    114 GitHub stars~6.1k tokensUpdated 6 mo ago
    DevelopmentAuto-check: notes
  • Expertreview

    jtenniswood/esphome-media-player

    Provide an expert codebase review for this repository. An agent skill from jtenniswood/esphome-media-player.

    234 GitHub stars~1.9k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Review

    mag123c/toktrack

    Multi-agent code review for Rust CLI/TUI. An agent skill from mag123c/toktrack.

    193 GitHub stars~1.2k tokensUpdated 7 days ago
    DevelopmentAuto-check passed
  • Loft Design Prototyping

    Yeachan-Heo/oh-my-claudecode

    Settles stalled design questions by building a throwaway artifact: either a pure logic module in a clickable shell, or three structurally different UI variants.

    40k GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Update Turbo

    tobihagemann/turbo

    Update installed Turbo skills from the local repo with a dynamic changelog, conflict resolution for customized skills, and guided user experience.

    407 GitHub stars~168 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from MoonshotAI/kimi-code

All 11 skills in this repo
  • Kimi Webbridge

    MoonshotAI/kimi-code

    Kimi Browser Extension(Kimi 浏览器扩展,原 Kimi WebBridge)lets AI control the user's real browser — navigate, click, type, read, screenshot, and interact with any website using the user's actual login…

    7.8k GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Gen Changesets

    MoonshotAI/kimi-code

    A skill your agent uses when generating changesets in the kimi-code repository — deciding whether to write one, which package to list, the bump level, the wording, and the confirmation workflow.

    7.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Kimi Datasource

    MoonshotAI/kimi-code

    Universal data-source assistant for stocks (Wind, S&P, SEC EDGAR), macro (World Bank, IMF, FRED, NBS), Chinese government data and standards (GB/HB/DB/TT), corporate, academic, legal, WHO/FAO/OECD…

    7.8k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Pre Changelog

    MoonshotAI/kimi-code

    Use before merging a kimi-code release PR to preview the user-facing CLI changelog in Chinese.

    7.8k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Review PR

    MoonshotAI/kimi-code

    在 kimi-code 仓库里 review 一个 PR 时使用:按 PR 模板逐节核对描述与 diff,并单独做一轮"回归与用户影响"评审,给出影响等级与评审摘要,评审摘要用用户当前使用的语言。

    7.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Write PR

    MoonshotAI/kimi-code

    在 kimi-code 仓库里创建或更新 PR 时使用:如何把 PR 模板的每一节写得简洁、便于 reviewer 理解,包括"行为变化与受影响人群"表。

    7.8k GitHub stars~909 tokensUpdated today
    Auto-check passed

Works with

Questions about Gen Docs

What does Gen Docs do?

Update Kimi Code CLI user documentation after meaningful code changes that affect product behavior or user experience. Gen Docs is an agent skill from MoonshotAI/kimi-code. Update Kimi Code CLI user documentation after meaningful code changes that affect product behavior or user experience.

When should I use Gen Docs?

Gen Docs fits situations like: tasks that involve UX design.

How do I install Gen Docs in Claude Code?

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

How do I install Gen Docs in Codex?

Run `npx skills add MoonshotAI/kimi-code --skill gen-docs -a codex`. Or copy the skill folder (.agents/skills/gen-docs in MoonshotAI/kimi-code) into .agents/skills/gen-docs in your project. Codex loads it when a task matches its description.

Can I use Gen 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 MoonshotAI/kimi-code --skill gen-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/gen-docs, .gemini/skills/gen-docs, .github/skills/gen-docs and .opencode/skills/gen-docs in your project.

What does Gen Docs need to run?

Going by SKILL.md and its folder, Gen Docs needs the command-line tools its instructions call (git and node). Our summary lists: A credential in YOUR_API_KEY.

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

Gen Docs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gen Docs use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 Gen Docs?

Skills that share tags, products or a category with Gen Docs: Extension Reviewer (vicinaehq/extensions, 155 stars), Ostack (mr-daedalium/ostack-saas, 114 stars), Expertreview (jtenniswood/esphome-media-player, 234 stars) and Review (mag123c/toktrack, 193 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gen Docs?

MoonshotAI (a GitHub organization) maintains it in MoonshotAI/kimi-code, which has 7,796 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

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