skills.rest
tatsushige-i
tatsushige-iCOMMUNITY
Explore all skills by this author →
GitHub

local-docs-validate

Audit SKILL.md frontmatter, README structure, symlinks, and Japanese translations for consistency.

Updated Mar 21, 2026
Search Tags:#documentation#consistency#validation#translation#readme#symlink
One-click install
npx skills add https://github.com/tatsushige-i/shared-claude-code --skill local-docs-validate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: local-docs-validate
Source: https://github.com/tatsushige-i/shared-claude-code/tree/main/.claude/skills/local-docs-validate
Command: npx skills add https://github.com/tatsushige-i/shared-claude-code --skill local-docs-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate documentation consistency across the shared-claude-code repository by auditing SKILL frontmatter, README structure, symlinks, and translations.

Core Features & Use Cases

  • Audits SKILL.md frontmatter for each skill to ensure name and description exist
  • Verifies symlink integrity under .claude/skills and cross-checks with skills/ and docs/ja-JP translations
  • Checks that README structure sections and Japanese translations align with English references
  • Suggests and applies automatic fixes where feasible

Quick Start

Run this skill to audit documentation across the repository and auto-fix non-breaking inconsistencies.

Frequently Asked Questions about local-docs-validate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check documentation consistency across multiple repositories?▼

Documentation consistency is verified by auditing SKILL.md frontmatter, README structures, symlinks, and translations to identify alignment issues across shared and consuming repositories.

What does validating SKILL.md frontmatter involve?▼

Validating SKILL.md frontmatter involves checking that required name and description fields exist and are complete for each skill in the repository.

How do I verify symlink integrity for documentation files?▼

Verifying symlink integrity involves checking links under .claude/skills and cross-referencing them with the skills/ directory and docs/ja-JP translation files to ensure paths resolve correctly.

Can I automatically fix README and translation misalignment issues?▼

Yes, automatic fix suggestions are provided for non-breaking inconsistencies where README structure sections and Japanese translations can be safely aligned with their English references.

Does this documentation validation work for Japanese translation files?▼

Yes, it checks that Japanese translations in docs/ja-JP align with the English README references and associated skill documentation to maintain translation parity.

What are the limitations of automated documentation validation?▼

Automated validation is limited to detecting structural inconsistencies, missing frontmatter, broken symlinks, and translation misalignment, providing auto-fix suggestions only for non-breaking issues.

Related Skills

Explore More Content & Communication Skills→
tatsushige-itatsushige-i

docs-validate

Scan Claude codebases to validate SKILL.md frontmatter, symlinks, and README structure.

Community
Intermediate
baekenoughbaekenough
13

omcustom:fix-refs

Audit, fix, and validate broken agent references and symlinks.

Community
Advanced
ntluong95ntluong95

Statistical Code Review

Review R statistical analysis code for reproducibility and model specification.

Community
Intermediate
LamseyahEliasLamseyahElias

hermes-agent-skill-authoring

Define in-repo Hermes-Agent skills with SKILL.md and YAML frontmatter.

Community
Intermediate