gen-docs

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

Quality

65%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/gen-docs/SKILL.md

Quality

Content

68%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill is a well-structured, actionable instruction-only workflow with concrete commands and clear sequencing. Its main gap is the absence of an explicit verification feedback loop for the batch bilingual-sync operation.

Suggestions

Add a final validation step (e.g. 'run the docs build / re-read the diff to confirm both locales are mirrored') with a fix-and-retry loop.

Tighten the Overview prose to remove near-duplicate statements about when to use the skill.

Inline a short summary of the AGENTS.md terminology rule so the doc-editing step is more self-contained.

Dimension	Reasoning	Score
Conciseness	The body is efficient and assumes Claude's competence, using concrete commands and paths with minimal padding; only a few prose sentences could be tightened further.	4 / 5
Actionability	Provides concrete, executable commands (git log/diff, node sync script) and specific file paths; the doc-editing step defers detail to docs/AGENTS.md, leaving a minor gap rather than being fully self-contained.	4 / 5
Workflow Clarity	The five-step sequence is clear with stopping checkpoints (prerequisites check, step-2 no-impact stop), but this batch bilingual-sync workflow lacks a validate→fix→retry verification loop, which caps it at 3 per the batch-operations guidance.	3 / 5
Progressive Disclosure	Well-organized into Overview/Prerequisites/Workflow/Rules/Common mistakes with one-level-deep references to repo files (docs/AGENTS.md, sync script, sibling skills); no bundle files exist, and at ~85 lines it exceeds the under-50-line simple-skill exception.	4 / 5
	Total	15 / 20 Passed

Description

62%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description clearly states what the skill does and when to use it, scoped to a specific product niche. It is slightly held back by listing only one action and missing common trigger-term synonyms.

Suggestions

List a couple more concrete actions (e.g. 'sync changelogs, update bilingual pages') to lift specificity.

Add natural trigger synonyms users actually say, such as 'docs', 'release notes', or 'changelog'.

Consider an explicit 'Use when...' clause to make the trigger unambiguous.

Dimension	Reasoning	Score
Specificity	Names the domain ('Kimi Code CLI user documentation') and one concrete action ('Update'), but does not enumerate multiple specific actions, so it is not comprehensive.	3 / 5
Completeness	It answers both what ('Update Kimi Code CLI user documentation') and when ('after meaningful code changes that affect product behavior or user experience'), with the when clause fairly explicit, though it lacks a canonical 'Use when...' trigger phrase.	4 / 5
Trigger Term Quality	Relevant keywords ('documentation', 'code changes', 'product behavior', 'user experience') are present, but common natural variations a user might say (e.g. 'docs', 'release notes', 'changelog') are missing.	3 / 5
Distinctiveness Conflict Risk	Scoped to a specific product's user docs, giving it a clear niche with minimal conflict risk; only minor overlap with the sibling audit-docs skill.	4 / 5
	Total	14 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: MoonshotAI/kimi-code
Path: .agents/skills/gen-docs/SKILL.md
Commit: d4e0ad4

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.