菜单
Automatically detect and fix documentation inconsistencies, outdated examples, and missing @file headers in the u-he-preset-randomizer project. Triggers when documentation appears outdated or when making significant code changes that affect public APIs. Use when this capability is needed.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/tomevault-io/skills-registry --skill documentation-review命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | documentation-review |
| description | Automatically detect and fix documentation inconsistencies, outdated examples, and missing @file headers in the u-he-preset-randomizer project. Triggers when documentation appears outdated or when making significant code changes that affect public APIs. Use when this capability is needed. |
| metadata | {"author":"Fannon"} |
This skill proactively identifies documentation issues and suggests fixes for the u-he-preset-randomizer project.
Automatically trigger this skill when:
u-he-preset-randomizer - CLI tool and MCP server for u-he synth preset generation:
src/cli.ts) - Main command-line toolsrc/mcp-server.ts) - Model Context Protocol server for AI assistantsVerify examples use correct flags:
--synth - Synth name (e.g., Diva, Hive)--amount - Number of presets to generate--randomness - Percentage (0-100) for randomization--preset - Base preset name or ? for random--merge - Preset names to merge (can be multiple)--pattern - Glob pattern for preset filtering--folder - Filter by folder path--category - Filter by category--author - Filter by author--favorites - Filter by .uhe-fav file--stable - Use stable randomization mode--binary - Include binary section (⚠️ may cause crashes)--dictionary - Use dictionary for random names--custom-folder - Custom u-he installation path--debug - Enable debug loggingVerify MCP_SERVER.md examples match src/mcp-server.ts:
list_synths - Detect available synthsselect_synth - Load preset library (with optional pattern)get_current_synth - Get active synth infolist_presets - List with paginationsearch_presets - Fuzzy searchfilter_presets - Filter by category/author/favorites/patternexplain_preset - Get preset detailsget_categories, get_authors, get_favorites_files - Metadata helpersgenerate_random_presets - Generate from distributionsrandomize_presets - Create variationsmerge_presets - Blend multiple presetsget_synth_context - Get synth reference docsAll TypeScript files must have @file headers:
/**
* @file Brief description of module's purpose.
*/
Exported functions need JSDoc (if not obvious from types):
/**
* Function description explaining what it does.
*
* @param paramName - Parameter description
* @returns What the function returns
* @throws {Error} When it throws errors
*/
export function myFunction(paramName: string): ReturnType { ... }
Key files to document:
src/index.ts - Public API exportssrc/parser.ts - Preset parsing/serialization (public API)src/cli.ts - CLI entry pointsrc/mcp-server.ts - MCP serversrc/generatePresets.ts - Main generation functionsrc/*.ts files1. Small issues (typos, outdated examples, missing headers):
npm run lint && npm run typecheck2. Medium issues (multiple outdated sections, missing documentation):
3. Major issues (significant inconsistencies, large gaps):
/documentation@file Headers:
// Entry points
/**
* @file CLI entry point for u-he preset randomizer tool.
* Handles argument parsing, interactive mode, and orchestration.
*/
// Core modules
/**
* @file Preset parser and serializer for u-he preset files.
* Provides functions to read, parse, and write .h2p preset files.
*/
// Utilities
/**
* @file Utility functions for preset validation.
*/
JSDoc for Public Functions:
/**
* Parses a u-he preset file into a structured object.
*
* @param fileString - The content of the preset file
* @param filePath - Path to the file (for error messages)
* @param binary - Whether to include binary section
* @returns Parsed preset object with metadata and parameters
*/
export function parseUhePreset(
fileString: string,
filePath: string,
binary: boolean,
): Preset { ... }
Avoid redundant JSDoc:
// ❌ Don't document what's obvious from types
/**
* Gets the preset name
* @param preset - The preset
* @returns The name
*/
function getName(preset: Preset): string { ... }
// ✅ Let TypeScript speak for simple functions
function getName(preset: Preset): string { ... }
After any documentation changes:
npm run lint # Biome linting (must pass)
npm run typecheck # TypeScript type checking (must pass)
npm run test:unit # Unit tests (must pass)
Optional build check:
npm run build:dist # Production build (for major changes)
Never modify:
Always ask before:
Auto-fix these safely:
For comprehensive reviews, this skill guides the user to use:
/documentation
Which performs:
Source: Fannon/u-he-preset-randomizer — distributed by TomeVault.