Gardening Skills Wiki

Validate links, naming, cross-references, and INDEX coverage in a skills wiki.

Updated Nov 27, 2025
One-click install
npx skills add https://github.com/barrydobson/dotfiles_extra --skill gardening-skills-wiki-barrydobson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Gardening Skills Wiki
Source: https://github.com/barrydobson/dotfiles_extra/tree/main/packages/claude/dot-claude/skills/meta/gardening-skills-wiki
Command: npx skills add https://github.com/barrydobson/dotfiles_extra --skill gardening-skills-wiki-barrydobson

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, grep, find, sed, realpath, jq, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the maintenance of your AI's skills wiki, preventing broken links, orphaned skills, inconsistent naming, and outdated INDEX files. It ensures the wiki remains a reliable, searchable, and high-quality knowledge base without requiring manual, token-intensive inspection.

Core Features & Use Cases

  • Automated Health Checks: Runs scripts to validate links, naming conventions, and INDEX file coverage across the entire skills repository.
  • Link Validation: Identifies broken @ references, backtick-wrapped links, and relative paths, suggesting fixes.
  • Naming Consistency: Checks directory names for kebab-case, frontmatter completeness, and active voice in skill names.
  • INDEX Coverage: Verifies all skills are listed in their category INDEX files and have descriptions.
  • Search Gap Analysis: Analyzes failed search queries to identify missing skills, guiding new skill creation.
  • Use Case: After adding, removing, or reorganizing skills, run garden.sh to instantly get a health report, ensuring all changes are consistent and maintain wiki integrity.

Quick Start

To perform a full health check of your skills wiki, run the master gardening script:

~/.claude/skills/meta/gardening-skills-wiki/garden.sh

Review the report for errors (❌) and warnings (⚠️), then fix any identified issues.

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 links and naming conventions across my skills wiki?

Link validation checks @-references, backtick-wrapped links, and relative paths for accuracy. Naming validation ensures directory kebab-case, complete frontmatter (name, description, when_to_use, version), and active voice. Run the master gardening script to identify broken links and naming drift instantly.

What's the best way to detect orphaned skills and INDEX coverage gaps?

INDEX coverage checks verify all skills are listed in their category INDEX files with descriptions. Orphan detection identifies skills not referenced elsewhere. The health check script runs both automatically, flagging missing or inconsistent entries in a single report.

How do I automate wiki maintenance after adding or removing skills?

Run the gardening script after any skill addition, removal, or reorganization to automatically detect broken links, naming inconsistencies, and INDEX discrepancies. The script processes frontmatter, directory structure, and cross-references, returning a health report with errors and warnings.

Can I use this to find gaps in my skills documentation?

Search gap analysis reviews failed search queries to identify missing skills and guide new skill creation. Combined with INDEX coverage checks, it reveals documentation gaps and helps prioritize new skill development.

What dependencies do I need to run wiki health checks?

Health checks require bash, grep, find, sed, realpath, and jq. These tools perform link resolution, frontmatter parsing, and JSON-based reporting. The gardening script bundles all logic into a single executable.

Does this work with existing wiki structures and naming schemes?

Yes, it validates against kebab-case directory naming and standard frontmatter fields. If your wiki uses different conventions, you can run automated fixes to align with the expected structure before full health checks.