Skip to content
Gardening Skills Wiki logo

Gardening Skills Wiki

Maintain skills wiki health - check links, naming, cross-references, and coverage

SKILL.md

Full skill instructions

Gardening Skills Wiki

Overview

The skills wiki needs regular maintenance to stay healthy: links break, skills get orphaned, naming drifts, INDEX files fall out of sync.

Core principle: Automate health checks to maintain wiki quality without burning tokens on manual inspection.

When to Use

Run gardening after:

  • Adding new skills
  • Removing or renaming skills
  • Reorganizing categories
  • Updating cross-references
  • Suspicious that links are broken

Periodic maintenance:

  • Weekly during active development
  • Monthly during stable periods

Quick Health Check

# Run all checks
~/​.claude/​skills/​meta/​gardening-skills-wiki/​garden.sh

# Or run specific checks
~/​.claude/​skills/​meta/​gardening-skills-wiki/​check-links.sh
~/​.claude/​skills/​meta/​gardening-skills-wiki/​check-naming.sh
~/​.claude/​skills/​meta/​gardening-skills-wiki/​check-index-coverage.sh

# Analyze search gaps (what skills are missing)
~/​.claude/​skills/​meta/​gardening-skills-wiki/​analyze-search-gaps.sh

The master script runs all checks and provides a health report.

What Gets Checked

1. Link Validation (check-links.sh)

Checks:

  • Backtick-wrapped @ links - backticks disable resolution
  • Relative paths like skills/ or skills/​gardening-skills-wiki/~/ - should use skills/ absolute paths
  • All skills/ references resolve to existing files
  • Skills referenced in INDEX files exist
  • Orphaned skills (not in any INDEX)

Fixes:

  • Remove backticks from @ references
  • Convert skills/ and skills/​gardening-skills-wiki/~/ relative paths to skills/ absolute paths
  • Update broken skills/ references to correct paths
  • Add orphaned skills to their category INDEX
  • Remove references to deleted skills

2. Naming Consistency (check-naming.sh)

Checks:

  • Directory names are kebab-case
  • No uppercase or underscores in directory names
  • Frontmatter fields present (name, description, when_to_use, version, type)
  • Skill names use active voice (not "How to...")
  • Empty directories

Fixes:

  • Rename directories to kebab-case
  • Add missing frontmatter fields
  • Remove empty directories
  • Rephrase names to active voice

3. INDEX Coverage (check-index-coverage.sh)

Checks:

  • All skills listed in their category INDEX
  • All category INDEX files linked from main INDEX
  • Skills have descriptions in INDEX entries

Fixes:

  • Add missing skills to INDEX files
  • Add category links to main INDEX
  • Add descriptions for INDEX entries

Common Issues and Fixes

Broken Links

❌ BROKEN: skills/​debugging/​root-cause-tracing
   Target: /​path/​to/​skills/​debugging/​root-cause-tracing/​SKILL.md

Fix: Update the reference path - skill might have moved or been renamed.

Orphaned Skills

⚠️  ORPHANED: test-invariants/​SKILL.md not in testing/​INDEX.md

Fix: Add to the category INDEX:

- skills/​gardening-skills-wiki/​test-invariants - Description of skill

Backtick-Wrapped Links

❌ BACKTICKED: skills/​testing/​condition-based-waiting on line 31
   File: getting-started/​SKILL.md
   Fix: Remove backticks - use bare @ reference

Fix: Remove backticks:

# ❌ Bad - backticks disable link resolution
`skills/​testing/​condition-based-waiting`

# ✅ Good - bare @ reference
skills/​testing/​condition-based-waiting

Relative Path Links

❌ RELATIVE: skills/​testing in coding/​SKILL.md
   Fix: Use skills/ absolute path instead

Fix: Convert to absolute path:

# ❌ Bad - relative paths are brittle
skills/​testing/​condition-based-waiting

# ✅ Good - absolute skills/ path
skills/​testing/​condition-based-waiting

Naming Issues

⚠️  Mixed case: TestingPatterns (should be kebab-case)

Fix: Rename directory:

cd ~/​.claude/​skills/​testing
mv TestingPatterns testing-patterns
# Update all references to old name

Missing from INDEX

❌ NOT INDEXED: condition-based-waiting/​SKILL.md

Fix: Add to testing/​INDEX.md:

## Available Skills

- skills/​gardening-skills-wiki/​condition-based-waiting - Replace timeouts with condition polling

Empty Directories

⚠️  EMPTY: event-based-testing

Fix: Remove if no longer needed:

rm -rf ~/​.claude/​skills/​event-based-testing

Naming Conventions

Directory Names

  • Format: kebab-case (lowercase with hyphens)
  • Process skills: Use gerunds when appropriate (creating-skills, testing-skills)
  • Pattern skills: Use core concept (flatten-with-flags, test-invariants)
  • Avoid: Mixed case, underscores, passive voice starters ("how-to-")

Frontmatter Requirements

Required fields:

  • name: Human-readable name
  • description: One-line summary
  • when_to_use: Symptoms and situations (CSO-critical)
  • version: Semantic version

Optional fields:

  • languages: Applicable languages
  • dependencies: Required tools
  • context: Special context (e.g., "AI-assisted development")

Automation Workflow

After Adding New Skill

# 1. Create skill
mkdir -p ~/​.claude/​skills/​category/​new-skill
vim ~/​.claude/​skills/​category/​new-skill/​SKILL.md

# 2. Add to category INDEX
vim ~/​.claude/​skills/​category/​INDEX.md

# 3. Run health check
~/​.claude/​skills/​meta/​gardening-skills-wiki/​garden.sh

# 4. Fix any issues reported

After Reorganizing

# 1. Move/​rename skills
mv ~/​.claude/​skills/​old-category/​skill ~/​.claude/​skills/​new-category/

# 2. Update all references (grep for old paths)
grep -r "skills/​gardening-skills-wiki/​old-category/​skill" ~/​.claude/​skills/

# 3. Run health check
~/​.claude/​skills/​meta/​gardening-skills-wiki/​garden.sh

# 4. Fix broken links

Periodic Maintenance

# Monthly: Run full health check
~/​.claude/​skills/​meta/​gardening-skills-wiki/​garden.sh

# Review and fix:
# - ❌ errors (broken links, missing skills)
# - ⚠️  warnings (naming, empty dirs)

The Scripts

garden.sh (Master)

Runs all health checks and provides comprehensive report.

Usage:

~/​.claude/​skills/​meta/​gardening-skills-wiki/​garden.sh [skills_dir]

check-links.sh

Validates all @ references and cross-links.

Checks:

  • Backtick-wrapped @ links (disables resolution)
  • Relative paths (skills/ or skills/​gardening-skills-wiki/~/) - should be skills/
  • @ reference resolution to existing files
  • Skills in INDEX files exist
  • Orphaned skills detection

check-naming.sh

Validates naming conventions and frontmatter.

Checks:

  • Directory name format
  • Frontmatter completeness
  • Empty directories

check-index-coverage.sh

Validates INDEX completeness.

Checks:

  • Skills listed in category INDEX
  • Categories linked in main INDEX
  • Descriptions present

Quick Reference

IssueScriptFix
Backtick-wrapped linkscheck-links.shRemove backticks from @ refs
Relative pathscheck-links.shConvert to skills/ absolute
Broken linkscheck-links.shUpdate @ references
Orphaned skillscheck-links.shAdd to INDEX
Naming issuescheck-naming.shRename directories
Empty dirscheck-naming.shRemove with rm -rf
Missing from INDEXcheck-index-coverage.shAdd to INDEX.md
No descriptioncheck-index-coverage.shAdd to INDEX entry

Output Symbols

  • ✅ Pass - Item is correct
  • ❌ Error - Must fix (broken link, missing skill)
  • ⚠️ Warning - Should fix (naming, empty dir)
  • ℹ️ Info - Informational (no action needed)

Integration with Workflow

Before committing skill changes:

~/​.claude/​skills/​meta/​gardening-skills-wiki/​garden.sh
# Fix all ❌ errors
# Consider fixing ⚠️  warnings
git add .
git commit -m "Add/​update skills"

When links feel suspicious:

~/​.claude/​skills/​meta/​gardening-skills-wiki/​check-links.sh

When INDEX seems incomplete:

~/​.claude/​skills/​meta/​gardening-skills-wiki/​check-index-coverage.sh

Common Rationalizations

ExcuseReality
"Will check links manually"Automated check is faster and more thorough
"INDEX probably fine"Orphaned skills happen - always verify
"Naming doesn't matter"Consistency aids discovery and maintenance
"Empty dir harmless"Clutter confuses future maintainers
"Can skip periodic checks"Issues compound - regular maintenance prevents big cleanups

Real-World Impact

Without gardening:

  • Broken links discovered during urgent tasks
  • Orphaned skills never found
  • Naming drifts over time
  • INDEX files fall out of sync

With gardening:

  • 30-second health check catches issues early
  • Automated validation prevents manual inspection
  • Consistent structure aids discovery
  • Wiki stays maintainable

The Bottom Line

Don't manually inspect - automate the checks.

Run garden.sh after changes and periodically. Fix ❌ errors immediately, address ⚠️ warnings when convenient.

Maintained wiki = findable skills = reusable knowledge.

More skills from boisenoise

database-cloud-optimization-cost-optimize logo
boisenoise/skills-collections

database-cloud-optimization-cost-optimize

You are a cloud cost optimization expert specializing in reducing infrastructure expenses while maintaining performance and reliability. Analyze cloud spending, identify savings opportunities, and implement cost-effective architectures across AWS, Azure, and GCP.

10 0
View
postmark-automation logo
boisenoise/skills-collections

postmark-automation

Automate Postmark email delivery tasks via Rube MCP (Composio): send templated emails, manage templates, monitor delivery stats and bounces. Always search tools first for current schemas.

10 0
View
game-development logo
boisenoise/skills-collections

game-development

Game development orchestrator. Routes to platform-specific skills based on project needs.

10 0
View
test-fixing logo
boisenoise/skills-collections

test-fixing

Systematically identify and fix all failing tests using smart grouping strategies. Use when explicitly asks to fix tests (\"fix these tests\", \"make tests pass\"), reports test failures (\"tests are failing\", \"test suite is broken\"), or completes implementation and wants tests passing.

10 0
View
notebooklm logo
boisenoise/skills-collections

notebooklm

Interact with Google NotebookLM to query documentation with Gemini's source-grounded answers. Each question opens a fresh browser session, retrieves the answer exclusively from your uploaded documents, and closes.

10 0
View
agent-evaluation logo
boisenoise/skills-collections

agent-evaluation

Testing and benchmarking LLM agents including behavioral testing,

10 0
View
clickup-automation logo
boisenoise/skills-collections

clickup-automation

Automate ClickUp project management including tasks, spaces, folders, lists, comments, and team operations via Rube MCP (Composio). Always search tools first for current schemas.

10 0
View
wordpress-penetration-testing logo
boisenoise/skills-collections

wordpress-penetration-testing

Assess WordPress installations for common vulnerabilities and WordPress 7.0 attack surfaces.

10 0
View
ln-761-secret-scanner logo
boisenoise/skills-collections

ln-761-secret-scanner

Scans codebase for hardcoded secrets with severity classification and remediation guidance. Use when auditing a project for leaked credentials.

10 0
View
azure-monitor-ingestion-java logo
boisenoise/skills-collections

azure-monitor-ingestion-java

Azure Monitor Ingestion SDK for Java. Send custom logs to Azure Monitor via Data Collection Rules (DCR) and Data Collection Endpoints (DCE).

10 0
View
ln-513-agent-reviewer logo
boisenoise/skills-collections

ln-513-agent-reviewer

Runs parallel external agent reviews (Codex + Gemini) on code changes. Process-as-arrive, critical verification with debate. Returns filtered suggestions.

10 0
View
drip-jobs-automation logo
boisenoise/skills-collections

drip-jobs-automation

Automate Drip Jobs tasks via Rube MCP (Composio). Always search tools first for current schemas.

10 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View