Gardening Skills Wiki

Validate wiki links, naming, frontmatter, and INDEX coverage via garden.sh.

41|27|Updated Oct 6, 2025

Search Tags:#automation #quality assurance #documentation #automated testing #naming conventions #wiki maintenance #link validation

Ready to run

npx skills add https://github.com/obra/clank --skill gardening-skills-wiki-obra

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Gardening Skills Wiki
Source: https://github.com/obra/clank/tree/main/skills/meta/gardening-skills-wiki
Command: npx skills add https://github.com/obra/clank --skill gardening-skills-wiki-obra

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve?

This Skill prevents skills wiki decay by automatically detecting broken links, naming inconsistencies, and missing INDEX entries that make skills unfindable.

Core Features & Use Cases

Link Validation: Checks for backtick-wrapped @ links, relative paths, and broken skill references.
Naming Consistency: Ensures directory names follow kebab-case conventions and frontmatter is complete.
Use Case: After adding new skills or reorganizing categories, run this Skill to automatically identify orphaned skills, broken cross-references, and naming issues before they compound.
INDEX Coverage: Verifies all skills are properly listed in category INDEX files with descriptions.

Quick Start

Run the master gardening script to check all wiki health aspects: ~/.claude/skills/meta/gardening-skills-wiki/garden.sh

Frequently Asked Questions about Gardening Skills Wiki

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

FAQPage Schema

How do I validate broken links in a documentation wiki?▼

Link validation checks backtick-wrapped references, relative paths, and skill cross-references to identify broken connections. Run garden.sh to automatically scan your wiki and report all broken links with their locations and fixes.

How do I ensure consistent naming conventions across wiki directories?▼

Naming consistency enforcement verifies all directories follow kebab-case conventions and have complete frontmatter fields (name, description, when_to_use, version). The health check detects naming drift and reports violations with corrections.

What happens when skills aren't listed in INDEX files?▼

Skills missing from category INDEX files become unfindable despite existing. INDEX coverage verification ensures all skill.md entries are properly indexed with descriptions, preventing orphaned content from compound wiki decay.

When should I run wiki health checks?▼

Run health checks after adding new skills, removing outdated ones, reorganizing categories, or updating cross-references. Periodic maintenance prevents broken links, naming inconsistencies, and INDEX gaps from accumulating undetected.

Can I detect orphaned skills and empty directories automatically?▼

Yes, the health check identifies orphaned skills and empty directories as part of comprehensive validation. It generates a detailed report with actionable fixes for all structural issues found during the scan.

What does a wiki health report include?▼

The comprehensive health report covers broken links, naming drift, missing frontmatter, empty directories, INDEX gaps, and orphaned skills. Each finding includes its location and recommended fix for remediation.