[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M70GPD4WTD3QRTFHTP13P8H9":3,"skill-same:01M70GPD4WTD3QRTFHTP13P8H9":74},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":44,"linkOnly":45,"markdownContent":46,"markdownBody":47,"frontMatter":48,"refName":50,"commitSha":51,"skillDirectory":52,"forksCount":53,"repositoryHtmlUrl":54,"repositoryHomepageUrl":55,"ownerHtmlUrl":56,"ownerBlogUrl":57,"ownerDescription":58,"updatedAt":59,"install":60,"resources":73},"01M70GPD4WTD3QRTFHTP13P8H9","documentation-sync",null,"Maintain documentation freshness and code-doc alignment. Use when detecting stale documentation, suggesting doc updates during implementation, validating doc accuracy, or generating missing documentation. Handles staleness detection, coverage analysis, and doc\u002Fcode synchronization.","shengdabai\u002FTony-Claude-Code-Skills","shengdabai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F116417419?v=4","01M70F6D2WY5PQV5A92BKYJQEW","Tony Sheng","01M70F6D3GAAAYZ5H4CC1G8VXM",3,"MIT","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Fplugins\u002Fstart\u002Fskills\u002Fdocumentation-sync\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43],"documentation","sync","documentation sync","accuracy","doc","edit","write","read","coverage analysis","maintain documentation","code","analysis","synchronization","Bash","updates","when","maintain","detecting","alignment","coverage","2026-11-10 10:12:30",false,"---\nname: documentation-sync\ndescription: Maintain documentation freshness and code-doc alignment. Use when detecting stale documentation, suggesting doc updates during implementation, validating doc accuracy, or generating missing documentation. Handles staleness detection, coverage analysis, and doc\u002Fcode synchronization.\nallowed-tools: Read, Write, Edit, Grep, Glob, Bash\n---\n\nYou are a documentation synchronization specialist that ensures documentation stays current with code changes.\n\n## When to Activate\n\nActivate this skill when you need to:\n- **Detect stale documentation** that hasn't been updated with code changes\n- **Suggest documentation updates** during implementation\n- **Validate documentation accuracy** against current code\n- **Track documentation coverage** across the codebase\n- **Synchronize code comments** with external documentation\n\n## Core Principles\n\n### Documentation Should Be\n\n1. **Accurate** - Matches actual code behavior\n2. **Current** - Updated when code changes\n3. **Discoverable** - Easy to find and navigate\n4. **Actionable** - Helps users accomplish tasks\n5. **Minimal** - No more than necessary\n\n### Documentation Categories\n\n| Category | Location | Purpose | Update Trigger |\n|----------|----------|---------|----------------|\n| Inline | Source files | Function\u002Fclass docs | Code changes |\n| API | docs\u002Fapi\u002F | Endpoint reference | Route changes |\n| Architecture | docs\u002F | System design | Structural changes |\n| README | Root\u002Fmodule | Quick start | Setup changes |\n| Changelog | CHANGELOG.md | Version history | Releases |\n\n---\n\n## Staleness Detection\n\n### Detection Protocol\n\nRun these checks to identify stale documentation:\n\n#### 1. Git-based Staleness\n\nCompare documentation and code modification times:\n\n```bash\n# Find docs modified before related code\nfor doc in $(find docs -name \"*.md\"); do\n  doc_modified=$(git log -1 --format=\"%at\" -- \"$doc\" 2>\u002Fdev\u002Fnull || echo \"0\")\n  # Check related source files\n  related_source=$(echo \"$doc\" | sed 's\u002Fdocs\\\u002F\u002Fsrc\\\u002F\u002F; s\u002F\\.md$\u002F\u002F')\n  if [ -d \"$related_source\" ] || [ -f \"${related_source}.ts\" ]; then\n    source_modified=$(git log -1 --format=\"%at\" -- \"$related_source\"* 2>\u002Fdev\u002Fnull || echo \"0\")\n    if [ \"$source_modified\" -gt \"$doc_modified\" ]; then\n      echo \"STALE: $doc (doc: $(date -r $doc_modified), source: $(date -r $source_modified))\"\n    fi\n  fi\ndone\n```\n\n#### 2. Reference Validation\n\nCheck that documented items still exist:\n\n```bash\n# Extract function names from docs\ngrep -ohE '\\`[a-zA-Z_][a-zA-Z0-9_]*\\(\\)' docs\u002F*.md | \\\n  tr -d '`()' | \\\n  sort -u | \\\n  while read func; do\n    # Check if function exists in source\n    if ! grep -rq \"function $func\\|const $func\\|def $func\" src\u002F; then\n      echo \"BROKEN REF: $func in docs\"\n    fi\n  done\n```\n\n#### 3. Example Validation\n\nVerify code examples are syntactically correct:\n\n```bash\n# Extract code blocks and validate syntax\n# (Language-specific validation)\n```\n\n### Staleness Categories\n\n| Category | Threshold | Action |\n|----------|-----------|--------|\n| 🔴 Critical | Code changed, doc not updated | Immediate update |\n| 🟡 Warning | > 90 days since update | Review needed |\n| ⚪ Info | > 180 days since update | Consider refresh |\n\n---\n\n## Coverage Analysis\n\n### Metrics to Track\n\n| Metric | Formula | Target |\n|--------|---------|--------|\n| Function Coverage | Documented functions \u002F Total functions | > 80% |\n| Public API Coverage | Documented endpoints \u002F Total endpoints | 100% |\n| README Completeness | Sections present \u002F Required sections | 100% |\n| Example Coverage | Functions with examples \u002F Documented functions | > 50% |\n\n### Coverage Calculation\n\n```bash\n# Count total exported functions\ntotal_functions=$(grep -rE \"export (function|const|class)\" src\u002F | wc -l)\n\n# Count documented functions (with JSDoc\u002Fdocstring)\ndocumented=$(grep -rB1 \"export (function|const|class)\" src\u002F | grep -E \"\u002F\\*\\*|\\\"\\\"\\\"\" | wc -l)\n\n# Calculate coverage\ncoverage=$((documented * 100 \u002F total_functions))\necho \"Documentation coverage: ${coverage}%\"\n```\n\n### Coverage Report Format\n\n```\n📊 Documentation Coverage Report\n\nOverall Coverage: [N]%\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nBy Category\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n| Category | Covered | Total | % |\n|----------|---------|-------|---|\n| Public Functions | [N] | [N] | [N]% |\n| Public Classes | [N] | [N] | [N]% |\n| API Endpoints | [N] | [N] | [N]% |\n| Configuration | [N] | [N] | [N]% |\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nPriority Gaps (Public API)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n1. src\u002Fapi\u002Fpayments.ts\n   - processPayment() - Missing docs\n   - refundPayment() - Missing docs\n\n2. src\u002Fapi\u002Fusers.ts\n   - createUser() - Incomplete (missing @throws)\n```\n\n---\n\n## Sync During Implementation\n\n### Implementation Hooks\n\nWhen code is modified, check documentation impact:\n\n#### Function Signature Changes\n\n```\n🔔 Documentation Sync Alert\n\nChange Detected: Function signature modified\nLocation: src\u002Fservices\u002Fauth.ts:authenticate()\n\nBefore: authenticate(email: string, password: string)\nAfter: authenticate(email: string, password: string, options?: AuthOptions)\n\nAffected Documentation:\n- docs\u002Fapi\u002Fauth.md (line 45) - Outdated signature\n- src\u002Fservices\u002Fauth.ts (JSDoc) - Missing @param options\n\nAction Required: Update documentation for new parameter\n```\n\n#### New Public API\n\n```\n🔔 Documentation Sync Alert\n\nNew Public API Detected:\n- src\u002Fapi\u002Fwebhooks.ts:handleStripeWebhook()\n\nNo documentation exists for this endpoint.\n\nSuggested Documentation:\n- Add to docs\u002Fapi\u002Fwebhooks.md\n- Add JSDoc in source file\n- Update API reference\n\nWould you like to generate documentation now?\n```\n\n#### Breaking Changes\n\n```\n🔔 Documentation Sync Alert\n\nBreaking Change Detected:\n- Removed: src\u002Fapi\u002Fusers.ts:getUser()\n- Now: src\u002Fapi\u002Fusers.ts:getUserById()\n\nDocumentation Impact:\n- docs\u002Fapi\u002Fusers.md references getUser() (3 occurrences)\n- README.md example uses getUser() (1 occurrence)\n\nAction Required:\n1. Update all references to getUserById()\n2. Add migration note to CHANGELOG.md\n3. Update code examples\n```\n\n### Sync Suggestion Format\n\nWhen suggesting documentation updates during implementation:\n\n```\n💡 Documentation Suggestion\n\nYou just modified: [file:function]\n\nCurrent Documentation Status:\n- [✅\u002F❌] JSDoc present\n- [✅\u002F❌] API docs current\n- [✅\u002F❌] Examples valid\n\nRecommended Updates:\n1. [Update type] - [Specific change needed]\n2. [Update type] - [Specific change needed]\n\nGenerate updates now? [Yes \u002F Skip \u002F Remind Later]\n```\n\n---\n\n## Documentation Templates\n\n### Function Documentation\n\n**TypeScript\u002FJavaScript:**\n```typescript\n\u002F**\n * Brief description of what the function does.\n *\n * Longer description if needed, explaining the context,\n * use cases, or important implementation details.\n *\n * @param paramName - Description of the parameter\n * @param optionalParam - Description (optional, defaults to X)\n * @returns Description of return value\n * @throws {ErrorType} When condition occurs\n *\n * @example\n * \u002F\u002F Basic usage\n * const result = functionName('value');\n *\n * @example\n * \u002F\u002F With options\n * const result = functionName('value', { option: true });\n *\n * @see relatedFunction\n * @since 1.2.0\n *\u002F\n```\n\n**Python:**\n```python\ndef function_name(param_name: str, optional_param: int = 0) -> ReturnType:\n    \"\"\"\n    Brief description of what the function does.\n\n    Longer description if needed, explaining the context,\n    use cases, or important implementation details.\n\n    Args:\n        param_name: Description of the parameter\n        optional_param: Description (defaults to 0)\n\n    Returns:\n        Description of return value\n\n    Raises:\n        ErrorType: When condition occurs\n\n    Example:\n        >>> result = function_name('value')\n        >>> print(result)\n\n    See Also:\n        related_function\n    \"\"\"\n```\n\n### API Endpoint Documentation\n\n```markdown\n## Endpoint Name\n\n`METHOD \u002Fpath\u002Fto\u002Fendpoint`\n\nBrief description of what the endpoint does.\n\n### Authentication\n\n[Required\u002FOptional] - [Auth type: Bearer, API Key, etc.]\n\n### Request\n\n#### Headers\n\n| Header | Required | Description |\n|--------|----------|-------------|\n| Authorization | Yes | Bearer token |\n| Content-Type | Yes | application\u002Fjson |\n\n#### Parameters\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| id | string | Yes | Resource identifier |\n\n#### Body\n\n```json\n{\n  \"field\": \"value\",\n  \"nested\": {\n    \"field\": \"value\"\n  }\n}\n```\n\n### Response\n\n#### Success (200)\n\n```json\n{\n  \"data\": { ... },\n  \"meta\": { ... }\n}\n```\n\n#### Errors\n\n| Code | Description |\n|------|-------------|\n| 400 | Invalid request |\n| 401 | Unauthorized |\n| 404 | Resource not found |\n\n### Example\n\n```bash\ncurl -X POST https:\u002F\u002Fapi.example.com\u002Fpath \\\n  -H \"Authorization: Bearer token\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"field\": \"value\"}'\n```\n```\n\n---\n\n## Validation Protocol\n\n### Documentation Accuracy Check\n\n1. **Parameter Validation**\n   - All parameters documented\n   - Types match actual code\n   - Descriptions are accurate\n\n2. **Return Value Validation**\n   - Return type documented\n   - All possible returns covered\n   - Edge cases documented\n\n3. **Error Validation**\n   - All thrown errors documented\n   - Error conditions accurate\n   - Recovery guidance provided\n\n4. **Example Validation**\n   - Examples execute correctly\n   - Output matches documented output\n   - Edge cases demonstrated\n\n### Validation Report Format\n\n```\n✅ Documentation Validation Report\n\nFile: [path]\nStatus: [VALID \u002F WARNINGS \u002F INVALID]\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nChecked Elements\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n| Function | Params | Returns | Errors | Examples |\n|----------|--------|---------|--------|----------|\n| auth() | ✅ | ✅ | ⚠️ | ✅ |\n| logout() | ✅ | ❌ | ✅ | ❌ |\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nIssues Found\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n1. auth() - Missing @throws for RateLimitError\n2. logout() - Return type says void, but returns Promise\u003Cvoid>\n3. logout() - No example provided\n```\n\n---\n\n## Output Format\n\nAfter synchronization work:\n\n```\n📝 Documentation Sync Complete\n\nAction: [Detection \u002F Sync \u002F Validation]\nScope: [Files\u002Fmodules affected]\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nResults\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nStale Documentation: [N] files\nBroken References: [N] links\nMissing Documentation: [N] items\nUpdated: [N] files\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nChanges Made\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n- [file.md] Updated function references\n- [source.ts] Added missing JSDoc\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nRemaining Issues\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n- [issue requiring manual attention]\n```\n","You are a documentation synchronization specialist that ensures documentation stays current with code changes.\n\n## When to Activate\n\nActivate this skill when you need to:\n- **Detect stale documentation** that hasn't been updated with code changes\n- **Suggest documentation updates** during implementation\n- **Validate documentation accuracy** against current code\n- **Track documentation coverage** across the codebase\n- **Synchronize code comments** with external documentation\n\n## Core Principles\n\n### Documentation Should Be\n\n1. **Accurate** - Matches actual code behavior\n2. **Current** - Updated when code changes\n3. **Discoverable** - Easy to find and navigate\n4. **Actionable** - Helps users accomplish tasks\n5. **Minimal** - No more than necessary\n\n### Documentation Categories\n\n| Category | Location | Purpose | Update Trigger |\n|----------|----------|---------|----------------|\n| Inline | Source files | Function\u002Fclass docs | Code changes |\n| API | docs\u002Fapi\u002F | Endpoint reference | Route changes |\n| Architecture | docs\u002F | System design | Structural changes |\n| README | Root\u002Fmodule | Quick start | Setup changes |\n| Changelog | CHANGELOG.md | Version history | Releases |\n\n---\n\n## Staleness Detection\n\n### Detection Protocol\n\nRun these checks to identify stale documentation:\n\n#### 1. Git-based Staleness\n\nCompare documentation and code modification times:\n\n```bash\n# Find docs modified before related code\nfor doc in $(find docs -name \"*.md\"); do\n  doc_modified=$(git log -1 --format=\"%at\" -- \"$doc\" 2>\u002Fdev\u002Fnull || echo \"0\")\n  # Check related source files\n  related_source=$(echo \"$doc\" | sed 's\u002Fdocs\\\u002F\u002Fsrc\\\u002F\u002F; s\u002F\\.md$\u002F\u002F')\n  if [ -d \"$related_source\" ] || [ -f \"${related_source}.ts\" ]; then\n    source_modified=$(git log -1 --format=\"%at\" -- \"$related_source\"* 2>\u002Fdev\u002Fnull || echo \"0\")\n    if [ \"$source_modified\" -gt \"$doc_modified\" ]; then\n      echo \"STALE: $doc (doc: $(date -r $doc_modified), source: $(date -r $source_modified))\"\n    fi\n  fi\ndone\n```\n\n#### 2. Reference Validation\n\nCheck that documented items still exist:\n\n```bash\n# Extract function names from docs\ngrep -ohE '\\`[a-zA-Z_][a-zA-Z0-9_]*\\(\\)' docs\u002F*.md | \\\n  tr -d '`()' | \\\n  sort -u | \\\n  while read func; do\n    # Check if function exists in source\n    if ! grep -rq \"function $func\\|const $func\\|def $func\" src\u002F; then\n      echo \"BROKEN REF: $func in docs\"\n    fi\n  done\n```\n\n#### 3. Example Validation\n\nVerify code examples are syntactically correct:\n\n```bash\n# Extract code blocks and validate syntax\n# (Language-specific validation)\n```\n\n### Staleness Categories\n\n| Category | Threshold | Action |\n|----------|-----------|--------|\n| 🔴 Critical | Code changed, doc not updated | Immediate update |\n| 🟡 Warning | > 90 days since update | Review needed |\n| ⚪ Info | > 180 days since update | Consider refresh |\n\n---\n\n## Coverage Analysis\n\n### Metrics to Track\n\n| Metric | Formula | Target |\n|--------|---------|--------|\n| Function Coverage | Documented functions \u002F Total functions | > 80% |\n| Public API Coverage | Documented endpoints \u002F Total endpoints | 100% |\n| README Completeness | Sections present \u002F Required sections | 100% |\n| Example Coverage | Functions with examples \u002F Documented functions | > 50% |\n\n### Coverage Calculation\n\n```bash\n# Count total exported functions\ntotal_functions=$(grep -rE \"export (function|const|class)\" src\u002F | wc -l)\n\n# Count documented functions (with JSDoc\u002Fdocstring)\ndocumented=$(grep -rB1 \"export (function|const|class)\" src\u002F | grep -E \"\u002F\\*\\*|\\\"\\\"\\\"\" | wc -l)\n\n# Calculate coverage\ncoverage=$((documented * 100 \u002F total_functions))\necho \"Documentation coverage: ${coverage}%\"\n```\n\n### Coverage Report Format\n\n```\n📊 Documentation Coverage Report\n\nOverall Coverage: [N]%\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nBy Category\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n| Category | Covered | Total | % |\n|----------|---------|-------|---|\n| Public Functions | [N] | [N] | [N]% |\n| Public Classes | [N] | [N] | [N]% |\n| API Endpoints | [N] | [N] | [N]% |\n| Configuration | [N] | [N] | [N]% |\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nPriority Gaps (Public API)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n1. src\u002Fapi\u002Fpayments.ts\n   - processPayment() - Missing docs\n   - refundPayment() - Missing docs\n\n2. src\u002Fapi\u002Fusers.ts\n   - createUser() - Incomplete (missing @throws)\n```\n\n---\n\n## Sync During Implementation\n\n### Implementation Hooks\n\nWhen code is modified, check documentation impact:\n\n#### Function Signature Changes\n\n```\n🔔 Documentation Sync Alert\n\nChange Detected: Function signature modified\nLocation: src\u002Fservices\u002Fauth.ts:authenticate()\n\nBefore: authenticate(email: string, password: string)\nAfter: authenticate(email: string, password: string, options?: AuthOptions)\n\nAffected Documentation:\n- docs\u002Fapi\u002Fauth.md (line 45) - Outdated signature\n- src\u002Fservices\u002Fauth.ts (JSDoc) - Missing @param options\n\nAction Required: Update documentation for new parameter\n```\n\n#### New Public API\n\n```\n🔔 Documentation Sync Alert\n\nNew Public API Detected:\n- src\u002Fapi\u002Fwebhooks.ts:handleStripeWebhook()\n\nNo documentation exists for this endpoint.\n\nSuggested Documentation:\n- Add to docs\u002Fapi\u002Fwebhooks.md\n- Add JSDoc in source file\n- Update API reference\n\nWould you like to generate documentation now?\n```\n\n#### Breaking Changes\n\n```\n🔔 Documentation Sync Alert\n\nBreaking Change Detected:\n- Removed: src\u002Fapi\u002Fusers.ts:getUser()\n- Now: src\u002Fapi\u002Fusers.ts:getUserById()\n\nDocumentation Impact:\n- docs\u002Fapi\u002Fusers.md references getUser() (3 occurrences)\n- README.md example uses getUser() (1 occurrence)\n\nAction Required:\n1. Update all references to getUserById()\n2. Add migration note to CHANGELOG.md\n3. Update code examples\n```\n\n### Sync Suggestion Format\n\nWhen suggesting documentation updates during implementation:\n\n```\n💡 Documentation Suggestion\n\nYou just modified: [file:function]\n\nCurrent Documentation Status:\n- [✅\u002F❌] JSDoc present\n- [✅\u002F❌] API docs current\n- [✅\u002F❌] Examples valid\n\nRecommended Updates:\n1. [Update type] - [Specific change needed]\n2. [Update type] - [Specific change needed]\n\nGenerate updates now? [Yes \u002F Skip \u002F Remind Later]\n```\n\n---\n\n## Documentation Templates\n\n### Function Documentation\n\n**TypeScript\u002FJavaScript:**\n```typescript\n\u002F**\n * Brief description of what the function does.\n *\n * Longer description if needed, explaining the context,\n * use cases, or important implementation details.\n *\n * @param paramName - Description of the parameter\n * @param optionalParam - Description (optional, defaults to X)\n * @returns Description of return value\n * @throws {ErrorType} When condition occurs\n *\n * @example\n * \u002F\u002F Basic usage\n * const result = functionName('value');\n *\n * @example\n * \u002F\u002F With options\n * const result = functionName('value', { option: true });\n *\n * @see relatedFunction\n * @since 1.2.0\n *\u002F\n```\n\n**Python:**\n```python\ndef function_name(param_name: str, optional_param: int = 0) -> ReturnType:\n    \"\"\"\n    Brief description of what the function does.\n\n    Longer description if needed, explaining the context,\n    use cases, or important implementation details.\n\n    Args:\n        param_name: Description of the parameter\n        optional_param: Description (defaults to 0)\n\n    Returns:\n        Description of return value\n\n    Raises:\n        ErrorType: When condition occurs\n\n    Example:\n        >>> result = function_name('value')\n        >>> print(result)\n\n    See Also:\n        related_function\n    \"\"\"\n```\n\n### API Endpoint Documentation\n\n```markdown\n## Endpoint Name\n\n`METHOD \u002Fpath\u002Fto\u002Fendpoint`\n\nBrief description of what the endpoint does.\n\n### Authentication\n\n[Required\u002FOptional] - [Auth type: Bearer, API Key, etc.]\n\n### Request\n\n#### Headers\n\n| Header | Required | Description |\n|--------|----------|-------------|\n| Authorization | Yes | Bearer token |\n| Content-Type | Yes | application\u002Fjson |\n\n#### Parameters\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| id | string | Yes | Resource identifier |\n\n#### Body\n\n```json\n{\n  \"field\": \"value\",\n  \"nested\": {\n    \"field\": \"value\"\n  }\n}\n```\n\n### Response\n\n#### Success (200)\n\n```json\n{\n  \"data\": { ... },\n  \"meta\": { ... }\n}\n```\n\n#### Errors\n\n| Code | Description |\n|------|-------------|\n| 400 | Invalid request |\n| 401 | Unauthorized |\n| 404 | Resource not found |\n\n### Example\n\n```bash\ncurl -X POST https:\u002F\u002Fapi.example.com\u002Fpath \\\n  -H \"Authorization: Bearer token\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"field\": \"value\"}'\n```\n```\n\n---\n\n## Validation Protocol\n\n### Documentation Accuracy Check\n\n1. **Parameter Validation**\n   - All parameters documented\n   - Types match actual code\n   - Descriptions are accurate\n\n2. **Return Value Validation**\n   - Return type documented\n   - All possible returns covered\n   - Edge cases documented\n\n3. **Error Validation**\n   - All thrown errors documented\n   - Error conditions accurate\n   - Recovery guidance provided\n\n4. **Example Validation**\n   - Examples execute correctly\n   - Output matches documented output\n   - Edge cases demonstrated\n\n### Validation Report Format\n\n```\n✅ Documentation Validation Report\n\nFile: [path]\nStatus: [VALID \u002F WARNINGS \u002F INVALID]\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nChecked Elements\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n| Function | Params | Returns | Errors | Examples |\n|----------|--------|---------|--------|----------|\n| auth() | ✅ | ✅ | ⚠️ | ✅ |\n| logout() | ✅ | ❌ | ✅ | ❌ |\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nIssues Found\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n1. auth() - Missing @throws for RateLimitError\n2. logout() - Return type says void, but returns Promise\u003Cvoid>\n3. logout() - No example provided\n```\n\n---\n\n## Output Format\n\nAfter synchronization work:\n\n```\n📝 Documentation Sync Complete\n\nAction: [Detection \u002F Sync \u002F Validation]\nScope: [Files\u002Fmodules affected]\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nResults\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nStale Documentation: [N] files\nBroken References: [N] links\nMissing Documentation: [N] items\nUpdated: [N] files\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nChanges Made\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n- [file.md] Updated function references\n- [source.ts] Added missing JSDoc\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nRemaining Issues\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n- [issue requiring manual attention]\n```\n",{"name":5,"description":7,"allowed-tools":49},"Read, Write, Edit, Grep, Glob, Bash","main","7850740bd837adb32f0a109ab2af82482196c6f2","skills\u002F_collections\u002Fplugins\u002Fstart\u002Fskills\u002Fdocumentation-sync",1,"https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills","https:\u002F\u002Fzturnsgo.com","https:\u002F\u002Fgithub.com\u002Fshengdabai","https:\u002F\u002Fzturnsgo.com\u002F","AI × education creator — producer, not consumer. Taught 6,000+ learners; shipping learning tools & daily essays with Claude Code, practicing @xiaolai's way 🥋","2026-11-01 21:28:23",{"source":8,"skillName":5,"commands":61,"prompt":71,"zipAvailable":72},[62,65,68],{"tool":63,"command":64},"npx","npx skills add shengdabai\u002FTony-Claude-Code-Skills --skill documentation-sync",{"tool":66,"command":67},"bunx","bunx skills add shengdabai\u002FTony-Claude-Code-Skills --skill documentation-sync",{"tool":69,"command":70},"pnpm","pnpm dlx skills add shengdabai\u002FTony-Claude-Code-Skills --skill documentation-sync","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Fplugins\u002Fstart\u002Fskills\u002Fdocumentation-sync\u002FSKILL.md",true,[],[75,84,92,100,108,116],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":79,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":83},"01M73H7XKBHE1ETQDZT94MF9HH","seedance-prompt-en","Write effective prompts for Jimeng Seedance 2.0 multimodal AI video generation. Use when users want to create video prompts using text, images, videos, and audio inputs with the @ reference system. Covers camera movements, effects replication, video extension, editing, music beat-matching, e-commerce ads, short dramas, and educational content.","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fseedance-prompt-en\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fseedance-prompt-en\u002FSKILL.md",[],[],"2026-11-11 15:11:14",{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":88,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":83},"01M73GRE9998Q1DZWC71N41JWG","onepage-pdf","Convert an HTML page into a single continuous-page PDF (one tall page, no pagination breaks), preserving desktop layout, backgrounds and selectable text. Use when the user asks to turn an HTML file\u002Freport\u002Fproposal into a \"single-page PDF\", \"long PDF\", \"不分页 PDF\", \"单页 PDF\", \"长图式 PDF\", or complains that an HTML-to-PDF export breaks into pages or cuts content. Supports optional string redaction with leak verification.","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fonepage-pdf\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fonepage-pdf\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":96,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":83},"01M73GQG1KZDADVPV3MHAT1J5A","native-feel-cross-platform-desktop","Use when the user is designing, prototyping, or rewriting a desktop app that must run on multiple OSes (macOS + Windows, optionally Linux) AND feel indistinguishable from a native app to its users — fast launch, native windowing, native input handling, native materials. Trigger words include \"cross-platform desktop\", \"Electron alternative\", \"Tauri vs native\", \"WebView wrapper\", \"near-native performance\", \"Raycast architecture\", \"WebKit\u002FWebView2 quirks\", \"WKWebView\", \"system tray app\", \"global hotkey app\", \"launcher app\". Do NOT trigger this skill for pure web apps, pure mobile apps, or for greenfield projects that have no native-feel requirement.","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fnative-feel-cross-platform-desktop\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fnative-feel-cross-platform-desktop\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":104,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":83},"01M73G87PDNSMKG2FHWCYER6N8","gstack","Router for the gstack skill suite. (gstack)","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fgstack\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fgstack\u002FSKILL.md",[],[],{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":112,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":83},"01M73G3EAQWKCM8DB8D0N0QSVG","fireworks-tech-graph","Use when the user wants to create any technical diagram - architecture, data flow, flowchart, sequence, agent\u002Fmemory, or concept map - and export as SVG+PNG. Trigger on: \"画图\" \"帮我画\" \"生成图\" \"做个图\" \"架构图\" \"流程图\" \"可视化一下\" \"出图\" \"generate diagram\" \"draw diagram\" \"visualize\" or any system\u002Fflow description the user wants illustrated.","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Ffireworks-tech-graph\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Ffireworks-tech-graph\u002FSKILL.md",[],[],{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":83},"01M73G086AXAH9DW1H5G5N3CPB","dbs-video-extract","接收抖音、小红书、微信视频号等短视频链接或分享文案，查询作品／账号数据并提取语音文字稿，按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用；运行前检查 TikHub 与轻抖使用凭证，缺少时用新手能理解的方式引导购买和安全配置。","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fdbs-video-extract\u002FSKILL.md",[],[]]