Documentation terminology
SkillDocs & knowledgeMaintain NiceEval documentation banned wording and diagnose writing-rule failures. Use when listing, adding, removing, or checking entries in docs/writing-rules.json; use docs/concepts.md instead when establishing a preferred domain term.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Documentation terminology skill
What this skill tells your AI
The instructions your AI receives, as published by niceeval/niceeval in .agents/skills/docs-terminology/SKILL.md and read by ahel’s review.
Read the writing rules before changing terminology. Its command owner is defined by Repository Tools.
Use pnpm run repo docs terms --help as the command reference. Do not hand-edit a second occurrence list.
- Run
pnpm run repo docs terms list <pattern>before adding a term. - Use
pnpm run repo docs terms add ... --dry-runto inspect the exact JSON change, then run the same command without--dry-run. - Choose
--scope docsfor design docs only,allfor design docs and the Chinese public site, orsitefor public-site wording only. - Run
pnpm run repo docs terms check, fix each contextual hit, then runpnpm lint. - Use
pnpm run repo docs terms remove <term> --dry-runbefore removing a decision. Removal deletes the entry and its site marker together.
Each handwritten ban needs the literal wording, a concrete replacement, and a reason. Put code identifiers in backticks instead of banning legitimate identifiers. If the decision establishes one preferred domain term over synonyms, record it once in docs/concepts.md; the writing lint derives synonym bans from that table.
Do not perform a whole-repository mechanical rewrite merely because a new entry exposes matches. Read each match in its owning feature or engineering context and use the precise action word for that context.
Signals
- GitHub stars
- 152
- Forks
- 4
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
docs-terminology- Source
- github.com/niceeval/niceeval