[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M736RV329FYRMM136K04TDT6":3,"skill-same:01M736RV329FYRMM136K04TDT6":59},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":37,"commitSha":38,"skillDirectory":39,"forksCount":40,"repositoryHtmlUrl":41,"repositoryHomepageUrl":6,"ownerHtmlUrl":42,"ownerBlogUrl":43,"ownerDescription":6,"updatedAt":44,"install":45,"resources":58},"01M736RV329FYRMM136K04TDT6","audit-discovery-symlinks",null,"Audit and repair Claude Code discovery symlinks for skills, agents, and teams. Compares registries against .claude\u002F directories at project and global levels, detects missing, broken, and extraneous symlinks, distinguishes almanac content from external projects, and optionally repairs gaps. Use after adding new skills or agents, after a repository rename or move, when slash commands stop working, or as a periodic health check.","roohe\u002Fagentic-super-skills","roohe","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99054084?v=4","01M734WCDFP6RZVT5CNM00QR26","01M734WCE4BD0T4NZS5PCV9V5F",10,"MIT","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Faudit-discovery-symlinks\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: audit-discovery-symlinks\nlocale: caveman-lite\nsource_locale: en\nsource_commit: 82c77053\ntranslator: \"Julius Brussee homage — caveman\"\ntranslation_date: \"2026-04-19\"\ndescription: >\n  Audit and repair Claude Code discovery symlinks for skills, agents, and teams.\n  Compares registries against .claude\u002F directories at project and global levels,\n  detects missing, broken, and extraneous symlinks, distinguishes almanac content\n  from external projects, and optionally repairs gaps. Use after adding new skills\n  or agents, after a repository rename or move, when slash commands stop working,\n  or as a periodic health check.\nlicense: MIT\nallowed-tools: Read Bash Grep Glob\nmetadata:\n  author: Philipp Thoss\n  version: \"1.0\"\n  domain: maintenance\n  complexity: intermediate\n  language: shell\n  tags: maintenance, symlinks, discovery, claude-code, audit\n---\n\n# audit-discovery-symlinks\n\n## When to Use\n\n- After adding new skills, agents, or teams to the almanac\n- After a repository rename or move that may have broken absolute symlinks\n- When slash commands or agents are not found in Claude Code\n- As a periodic health check to catch drift between registries and discovery paths\n- When onboarding a new project that should discover shared almanac content\n\n**Do NOT use** for creating the initial symlink hub from scratch. See the [symlink-architecture guide](..\u002F..\u002Fguides\u002Fsymlink-architecture.md) for first-time setup.\n\n## Inputs\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `almanac_path` | string | No | Absolute path to agent-almanac root. Auto-detected from `.claude\u002F` symlink targets or cwd if omitted |\n| `scope` | enum | No | `project`, `global`, or `both` (default: `both`) |\n| `fix_mode` | enum | No | `report` (default: audit only), `auto` (fix all safe issues), `interactive` (prompt before each fix) |\n\n## Procedure\n\n### Step 1: Identify Almanac Path\n\nLocate the agent-almanac root directory.\n\n```bash\n# Auto-detect from current project's .claude\u002Fagents symlink\nALMANAC_PATH=$(readlink -f .claude\u002Fagents 2>\u002Fdev\u002Fnull | sed 's|\u002Fagents$||')\n\n# Fallback: check if cwd is the almanac\nif [ -z \"$ALMANAC_PATH\" ] || [ ! -f \"$ALMANAC_PATH\u002Fskills\u002F_registry.yml\" ]; then\n  if [ -f \"skills\u002F_registry.yml\" ]; then\n    ALMANAC_PATH=$(pwd)\n  fi\nfi\n\n# Fallback: check global agents symlink\nif [ -z \"$ALMANAC_PATH\" ] || [ ! -f \"$ALMANAC_PATH\u002Fskills\u002F_registry.yml\" ]; then\n  ALMANAC_PATH=$(readlink -f ~\u002F.claude\u002Fagents 2>\u002Fdev\u002Fnull | sed 's|\u002Fagents$||')\nfi\n\necho \"Almanac path: $ALMANAC_PATH\"\n```\n\n**Got:** `ALMANAC_PATH` points to a directory containing `skills\u002F_registry.yml`, `agents\u002F_registry.yml`, and `teams\u002F_registry.yml`.\n\n**If fail:** If auto-detection fails, ask the user for the `almanac_path` input. The almanac root is the directory containing `skills\u002F`, `agents\u002F`, `teams\u002F`, and their registries.\n\n### Step 2: Inventory Registries\n\nExtract the canonical lists of skills, agents, and teams from their registries.\n\n```bash\n# Count registered skills (entries with \"- id:\" under domain sections)\nREGISTERED_SKILLS=$(grep '^ \\{6\\}- id:' \"$ALMANAC_PATH\u002Fskills\u002F_registry.yml\" | awk '{print $3}' | sort)\nREGISTERED_SKILL_COUNT=$(echo \"$REGISTERED_SKILLS\" | wc -l)\n\n# Count registered agents\nREGISTERED_AGENTS=$(grep '^ \\{2\\}- id:' \"$ALMANAC_PATH\u002Fagents\u002F_registry.yml\" | awk '{print $3}' | sort)\nREGISTERED_AGENT_COUNT=$(echo \"$REGISTERED_AGENTS\" | wc -l)\n\n# Count registered teams\nREGISTERED_TEAMS=$(grep '^ \\{2\\}- id:' \"$ALMANAC_PATH\u002Fteams\u002F_registry.yml\" | awk '{print $3}' | sort)\nREGISTERED_TEAM_COUNT=$(echo \"$REGISTERED_TEAMS\" | wc -l)\n\necho \"Registered: $REGISTERED_SKILL_COUNT skills, $REGISTERED_AGENT_COUNT agents, $REGISTERED_TEAM_COUNT teams\"\n```\n\n**Got:** Counts match the `total_skills`, `total_agents`, `total_teams` values in each registry header.\n\n**If fail:** If counts diverge from the header totals, the registry itself is out of sync. Note the discrepancy in the report but continue with the actual `- id:` entries as the source of truth.\n\n### Step 3: Audit Project-Level Symlinks\n\nCheck `.claude\u002Fskills\u002F*`, `.claude\u002Fagents`, `.claude\u002Fteams` in the current project directory.\n\n```bash\nPROJECT_CLAUDE=\".claude\"\n\n# --- Skills ---\n# Items on disk (excluding _template)\nPROJECT_SKILLS=$(ls \"$PROJECT_CLAUDE\u002Fskills\u002F\" 2>\u002Fdev\u002Fnull | grep -v '^_template$' | sort)\nPROJECT_SKILL_COUNT=$(echo \"$PROJECT_SKILLS\" | grep -c .)\n\n# Missing: in registry but not in project .claude\u002Fskills\u002F\nMISSING_PROJECT_SKILLS=$(comm -23 \u003C(echo \"$REGISTERED_SKILLS\") \u003C(echo \"$PROJECT_SKILLS\"))\n\n# Broken: symlink exists but target doesn't resolve\nBROKEN_PROJECT_SKILLS=$(find \"$PROJECT_CLAUDE\u002Fskills\u002F\" -maxdepth 1 -type l ! -exec test -e {} \\; -printf '%f\\n' 2>\u002Fdev\u002Fnull | sort)\n\n# Extraneous: in project but not in registry (and not external)\nEXTRA_PROJECT_SKILLS=$(comm -13 \u003C(echo \"$REGISTERED_SKILLS\") \u003C(echo \"$PROJECT_SKILLS\"))\n\n# --- Agents ---\nif [ -L \"$PROJECT_CLAUDE\u002Fagents\" ] || [ -d \"$PROJECT_CLAUDE\u002Fagents\" ]; then\n  PROJECT_AGENT_STATUS=\"OK\"\n  test -d \"$PROJECT_CLAUDE\u002Fagents\" || PROJECT_AGENT_STATUS=\"BROKEN\"\n  PROJECT_AGENT_COUNT=$(ls \"$PROJECT_CLAUDE\u002Fagents\u002F\"*.md 2>\u002Fdev\u002Fnull | wc -l)\nelse\n  PROJECT_AGENT_STATUS=\"MISSING\"\n  PROJECT_AGENT_COUNT=0\nfi\n\n# --- Teams ---\n# Teams are NOT symlinked. TeamCreate uses ~\u002F.claude\u002Fteams\u002F for runtime state.\n# A .claude\u002Fteams symlink is a misconfiguration — warn if found.\nif [ -L \"$PROJECT_CLAUDE\u002Fteams\" ]; then\n  PROJECT_TEAM_STATUS=\"MISCONFIGURED\"\n  PROJECT_TEAM_COUNT=0\n  # Stale symlink — should be removed to avoid collision with TeamCreate\nelse\n  PROJECT_TEAM_STATUS=\"OK\"\n  PROJECT_TEAM_COUNT=0\nfi\n```\n\n**Got:** Zero missing, zero broken. Extraneous items are classified and explained.\n\n**If fail:** If `.claude\u002F` does not exist at all, the project has no discovery setup. Note this and skip to global audit.\n\n### Step 4: Audit Global Symlinks\n\nCheck `~\u002F.claude\u002Fskills\u002F*` and `~\u002F.claude\u002Fagents`. Also check that `~\u002F.claude\u002Fteams` is NOT a symlink (it should be absent or a directory for TeamCreate runtime state).\n\n```bash\nGLOBAL_CLAUDE=\"$HOME\u002F.claude\"\n\n# --- Skills ---\nGLOBAL_SKILLS_ALL=$(ls \"$GLOBAL_CLAUDE\u002Fskills\u002F\" 2>\u002Fdev\u002Fnull | sort)\n\n# Classify each entry: almanac vs external\nALMANAC_GLOBAL_SKILLS=\"\"\nEXTERNAL_GLOBAL_SKILLS=\"\"\nfor item in $GLOBAL_SKILLS_ALL; do\n  target=$(readlink -f \"$GLOBAL_CLAUDE\u002Fskills\u002F$item\" 2>\u002Fdev\u002Fnull)\n  if [ -z \"$target\" ]; then\n    # Real directory (not a symlink) — external\n    EXTERNAL_GLOBAL_SKILLS=\"$EXTERNAL_GLOBAL_SKILLS $item\"\n  elif echo \"$target\" | grep -q \"^$ALMANAC_PATH\"; then\n    ALMANAC_GLOBAL_SKILLS=\"$ALMANAC_GLOBAL_SKILLS $item\"\n  else\n    EXTERNAL_GLOBAL_SKILLS=\"$EXTERNAL_GLOBAL_SKILLS $item\"\n  fi\ndone\n\n# Filter: _template is always extraneous for almanac content\nALMANAC_GLOBAL_SKILLS=$(echo \"$ALMANAC_GLOBAL_SKILLS\" | tr ' ' '\\n' | grep -v '^_template$' | grep -v '^$' | sort)\n\n# Missing: in registry but not in global almanac skills\nMISSING_GLOBAL_SKILLS=$(comm -23 \u003C(echo \"$REGISTERED_SKILLS\") \u003C(echo \"$ALMANAC_GLOBAL_SKILLS\"))\n\n# Broken: symlink exists but target doesn't resolve\nBROKEN_GLOBAL_SKILLS=$(find \"$GLOBAL_CLAUDE\u002Fskills\u002F\" -maxdepth 1 -type l ! -exec test -e {} \\; -printf '%f\\n' 2>\u002Fdev\u002Fnull | sort)\n\n# Stale almanac entries: in global almanac set but not in registry\nSTALE_GLOBAL_SKILLS=$(comm -13 \u003C(echo \"$REGISTERED_SKILLS\") \u003C(echo \"$ALMANAC_GLOBAL_SKILLS\"))\n\n# --- Agents ---\nif [ -L \"$GLOBAL_CLAUDE\u002Fagents\" ] || [ -d \"$GLOBAL_CLAUDE\u002Fagents\" ]; then\n  GLOBAL_AGENT_STATUS=\"OK\"\n  test -d \"$GLOBAL_CLAUDE\u002Fagents\" || GLOBAL_AGENT_STATUS=\"BROKEN\"\n  GLOBAL_AGENT_COUNT=$(ls \"$GLOBAL_CLAUDE\u002Fagents\u002F\"*.md 2>\u002Fdev\u002Fnull | wc -l)\nelse\n  GLOBAL_AGENT_STATUS=\"MISSING\"\n  GLOBAL_AGENT_COUNT=0\nfi\n\n# --- Teams ---\n# Teams are NOT symlinked. TeamCreate uses ~\u002F.claude\u002Fteams\u002F for runtime state.\n# A ~\u002F.claude\u002Fteams symlink is a misconfiguration — warn if found.\nif [ -L \"$GLOBAL_CLAUDE\u002Fteams\" ]; then\n  GLOBAL_TEAM_STATUS=\"MISCONFIGURED\"\n  GLOBAL_TEAM_COUNT=0\n  # Stale symlink — should be removed to avoid collision with TeamCreate\nelse\n  GLOBAL_TEAM_STATUS=\"OK\"\n  GLOBAL_TEAM_COUNT=0\nfi\n```\n\n**Got:** Zero missing almanac skills, zero broken. External content (peon-ping, etc.) is listed but not flagged as errors.\n\n**If fail:** If `~\u002F.claude\u002F` does not exist, the global hub is not set up. Refer to the [symlink-architecture guide](..\u002F..\u002Fguides\u002Fsymlink-architecture.md) for initial setup.\n\n### Step 5: Generate Audit Report\n\nProduce a summary table covering both layers.\n\n```markdown\n# Discovery Symlink Audit Report\n\n**Date**: YYYY-MM-DD\n**Almanac**: \u003Calmanac_path>\n**Scope**: both | project | global\n\n## Summary\n\n| Content | Registered | Project | Global (almanac) | Global (external) |\n|---------|------------|---------|-------------------|-------------------|\n| Skills  | N          | N       | N                 | N                 |\n| Agents  | N          | STATUS  | STATUS            | —                 |\n| Teams   | N          | STATUS  | STATUS            | —                 |\n\n## Issues\n\n### Missing (registered but no symlink)\n- Project skills: [list or \"none\"]\n- Global skills: [list or \"none\"]\n\n### Broken (symlink exists, target gone)\n- Project: [list or \"none\"]\n- Global: [list or \"none\"]\n\n### Extraneous\n- Stale almanac (in discovery but not registry): [list or \"none\"]\n- _template in discovery path: [yes\u002Fno]\n- External content (non-almanac): [list — informational only]\n```\n\n**Got:** A clear, actionable report. Zero issues means a clean bill of health.\n\n**If fail:** If report generation itself fails, output raw counts and lists to the console as fallback.\n\n### Step 6: Repair (Optional)\n\nIf `fix_mode` is `auto` or `interactive`, fix the issues found.\n\n**6a. Create missing project symlinks:**\n```bash\nfor skill in $MISSING_PROJECT_SKILLS; do\n  ln -s \"..\u002F..\u002Fskills\u002F$skill\" \"$PROJECT_CLAUDE\u002Fskills\u002F$skill\"\ndone\n```\n\n**6b. Create missing global symlinks:**\n```bash\nfor skill in $MISSING_GLOBAL_SKILLS; do\n  ln -s \"$ALMANAC_PATH\u002Fskills\u002F$skill\" \"$GLOBAL_CLAUDE\u002Fskills\u002F$skill\"\ndone\n```\n\n**6c. Remove broken symlinks:**\n```bash\n# Project\nfor broken in $BROKEN_PROJECT_SKILLS; do\n  rm \"$PROJECT_CLAUDE\u002Fskills\u002F$broken\"\ndone\n\n# Global\nfor broken in $BROKEN_GLOBAL_SKILLS; do\n  rm \"$GLOBAL_CLAUDE\u002Fskills\u002F$broken\"\ndone\n```\n\n**6d. Remove stale almanac entries:**\n```bash\n# Only remove items that target the almanac path but aren't in the registry\nfor stale in $STALE_GLOBAL_SKILLS; do\n  rm \"$GLOBAL_CLAUDE\u002Fskills\u002F$stale\"\ndone\n\n# Remove _template if present\nrm -f \"$GLOBAL_CLAUDE\u002Fskills\u002F_template\"\nrm -f \"$PROJECT_CLAUDE\u002Fskills\u002F_template\"\n```\n\n**6e. Fix missing directory symlinks (agents\u002Fteams):**\n```bash\n# Project agents\nif [ \"$PROJECT_AGENT_STATUS\" = \"MISSING\" ]; then\n  ln -s ..\u002Fagents \"$PROJECT_CLAUDE\u002Fagents\"\nfi\n\n# Project teams\nif [ \"$PROJECT_TEAM_STATUS\" = \"MISSING\" ]; then\n  ln -s ..\u002Fteams \"$PROJECT_CLAUDE\u002Fteams\"\nfi\n\n# Global agents\nif [ \"$GLOBAL_AGENT_STATUS\" = \"MISSING\" ]; then\n  ln -s \"$ALMANAC_PATH\u002Fagents\" \"$GLOBAL_CLAUDE\u002Fagents\"\nfi\n\n# Global teams\nif [ \"$GLOBAL_TEAM_STATUS\" = \"MISSING\" ]; then\n  ln -sf \"$ALMANAC_PATH\u002Fteams\" \"$GLOBAL_CLAUDE\u002Fteams\"\nfi\n```\n\n**Important:** Never remove items classified as external. These belong to other projects (e.g., peon-ping) and must be preserved.\n\n**Got:** All missing symlinks created, all broken symlinks removed, all stale almanac entries cleaned. External content untouched.\n\n**If fail:** If `ln -s` fails due to an existing file\u002Fdirectory at the target path (e.g., empty directory instead of symlink), remove the blocker first with `rmdir` (for empty dirs) or flag for manual review (for non-empty dirs).\n\n### Step 7: Verify\n\nRe-run the audit checks from Steps 3-4 to confirm repairs.\n\n```bash\necho \"=== Post-repair verification ===\"\necho \"Project skills: $(ls \"$PROJECT_CLAUDE\u002Fskills\u002F\" 2>\u002Fdev\u002Fnull | grep -v '^_template$' | wc -l)\"\necho \"Global skills (almanac): $(echo \"$ALMANAC_GLOBAL_SKILLS\" | wc -w)\"\necho \"Broken project: $(find \"$PROJECT_CLAUDE\u002Fskills\u002F\" -maxdepth 1 -type l ! -exec test -e {} \\; -print 2>\u002Fdev\u002Fnull | wc -l)\"\necho \"Broken global:  $(find \"$GLOBAL_CLAUDE\u002Fskills\u002F\" -maxdepth 1 -type l ! -exec test -e {} \\; -print 2>\u002Fdev\u002Fnull | wc -l)\"\necho \"Project agents: $PROJECT_AGENT_STATUS ($PROJECT_AGENT_COUNT .md files)\"\necho \"Global agents:  $GLOBAL_AGENT_STATUS ($GLOBAL_AGENT_COUNT .md files)\"\necho \"Project teams:  $PROJECT_TEAM_STATUS ($PROJECT_TEAM_COUNT .md files)\"\necho \"Global teams:   $GLOBAL_TEAM_STATUS ($GLOBAL_TEAM_COUNT .md files)\"\n```\n\n**Got:** Zero missing, zero broken. Counts match registered totals (for almanac content). External content listed separately.\n\n**If fail:** If issues remain after repair, report the specific failures. Common causes: permission errors on `~\u002F.claude\u002F`, NTFS path length limits on `\u002Fmnt\u002F` paths, or a non-empty directory blocking symlink creation.\n\n## Validation\n\n- [ ] Almanac path correctly identified and contains all three registries\n- [ ] Registry counts match `total_*` header values (or discrepancy noted)\n- [ ] Project-level skills, agents, and teams audited\n- [ ] Global-level skills, agents, and teams audited\n- [ ] External content (non-almanac) identified and excluded from issue counts\n- [ ] `_template` entries flagged as extraneous (never belongs in discovery paths)\n- [ ] Audit report generated with clear counts and actionable lists\n- [ ] If `fix_mode` is `auto`: all safe repairs applied, external content untouched\n- [ ] Post-repair verification confirms zero missing, zero broken\n\n## Pitfalls\n\n1. **Confusing external content with missing almanac content**: `~\u002F.claude\u002Fskills\u002F` may contain skills from other projects (e.g., peon-ping). Always check whether a symlink target is under the almanac path before classifying it as stale or extraneous.\n\n2. **Removing external content**: Never delete items that don't target the almanac. They belong to other projects and are intentional.\n\n3. **Symlinking `_template` directories**: Templates are scaffolding, not consumable content. The `_template` directory should never appear in `.claude\u002Fskills\u002F` or `.claude\u002Fagents\u002F`. Bulk sync scripts must explicitly skip it.\n\n4. **Stale `.claude\u002Fteams` symlink**: A `.claude\u002Fteams` symlink pointing to team definitions is a misconfiguration. Claude Code's `TeamCreate` uses `~\u002F.claude\u002Fteams\u002F` for runtime state (config.json, inboxes). If this path is a symlink to the almanac's `teams\u002F` directory, runtime artifacts will be written into the git-tracked repository. Remove any `.claude\u002Fteams` symlink found at project or global level.\n\n5. **Relative vs absolute paths**: Project-level skill symlinks use relative paths (`..\u002F..\u002Fskills\u002F\u003Cname>`). Global symlinks use absolute paths (`\u002Fpath\u002Fto\u002Falmanac\u002Fskills\u002F\u003Cname>`). Mixing these patterns causes breakage on moves.\n\n6. **Registry header vs actual count**: The `total_skills` field in the registry header may be stale if someone added entries without updating the count. Trust the actual `- id:` entries, not the header.\n\n## Related Skills\n\n- [repair-broken-references](..\u002Frepair-broken-references\u002FSKILL.md) -- general broken link and reference repair\n- [tidy-project-structure](..\u002Ftidy-project-structure\u002FSKILL.md) -- project directory organization\n- [create-skill](..\u002Fcreate-skill\u002FSKILL.md) -- includes symlink creation for new skills (Step 13)\n- [create-agent](..\u002Fcreate-agent\u002FSKILL.md) -- includes discovery verification (Step 10)\n- [create-team](..\u002Fcreate-team\u002FSKILL.md) -- team creation with registry integration\n","# audit-discovery-symlinks\n\n## When to Use\n\n- After adding new skills, agents, or teams to the almanac\n- After a repository rename or move that may have broken absolute symlinks\n- When slash commands or agents are not found in Claude Code\n- As a periodic health check to catch drift between registries and discovery paths\n- When onboarding a new project that should discover shared almanac content\n\n**Do NOT use** for creating the initial symlink hub from scratch. See the [symlink-architecture guide](..\u002F..\u002Fguides\u002Fsymlink-architecture.md) for first-time setup.\n\n## Inputs\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `almanac_path` | string | No | Absolute path to agent-almanac root. Auto-detected from `.claude\u002F` symlink targets or cwd if omitted |\n| `scope` | enum | No | `project`, `global`, or `both` (default: `both`) |\n| `fix_mode` | enum | No | `report` (default: audit only), `auto` (fix all safe issues), `interactive` (prompt before each fix) |\n\n## Procedure\n\n### Step 1: Identify Almanac Path\n\nLocate the agent-almanac root directory.\n\n```bash\n# Auto-detect from current project's .claude\u002Fagents symlink\nALMANAC_PATH=$(readlink -f .claude\u002Fagents 2>\u002Fdev\u002Fnull | sed 's|\u002Fagents$||')\n\n# Fallback: check if cwd is the almanac\nif [ -z \"$ALMANAC_PATH\" ] || [ ! -f \"$ALMANAC_PATH\u002Fskills\u002F_registry.yml\" ]; then\n  if [ -f \"skills\u002F_registry.yml\" ]; then\n    ALMANAC_PATH=$(pwd)\n  fi\nfi\n\n# Fallback: check global agents symlink\nif [ -z \"$ALMANAC_PATH\" ] || [ ! -f \"$ALMANAC_PATH\u002Fskills\u002F_registry.yml\" ]; then\n  ALMANAC_PATH=$(readlink -f ~\u002F.claude\u002Fagents 2>\u002Fdev\u002Fnull | sed 's|\u002Fagents$||')\nfi\n\necho \"Almanac path: $ALMANAC_PATH\"\n```\n\n**Got:** `ALMANAC_PATH` points to a directory containing `skills\u002F_registry.yml`, `agents\u002F_registry.yml`, and `teams\u002F_registry.yml`.\n\n**If fail:** If auto-detection fails, ask the user for the `almanac_path` input. The almanac root is the directory containing `skills\u002F`, `agents\u002F`, `teams\u002F`, and their registries.\n\n### Step 2: Inventory Registries\n\nExtract the canonical lists of skills, agents, and teams from their registries.\n\n```bash\n# Count registered skills (entries with \"- id:\" under domain sections)\nREGISTERED_SKILLS=$(grep '^ \\{6\\}- id:' \"$ALMANAC_PATH\u002Fskills\u002F_registry.yml\" | awk '{print $3}' | sort)\nREGISTERED_SKILL_COUNT=$(echo \"$REGISTERED_SKILLS\" | wc -l)\n\n# Count registered agents\nREGISTERED_AGENTS=$(grep '^ \\{2\\}- id:' \"$ALMANAC_PATH\u002Fagents\u002F_registry.yml\" | awk '{print $3}' | sort)\nREGISTERED_AGENT_COUNT=$(echo \"$REGISTERED_AGENTS\" | wc -l)\n\n# Count registered teams\nREGISTERED_TEAMS=$(grep '^ \\{2\\}- id:' \"$ALMANAC_PATH\u002Fteams\u002F_registry.yml\" | awk '{print $3}' | sort)\nREGISTERED_TEAM_COUNT=$(echo \"$REGISTERED_TEAMS\" | wc -l)\n\necho \"Registered: $REGISTERED_SKILL_COUNT skills, $REGISTERED_AGENT_COUNT agents, $REGISTERED_TEAM_COUNT teams\"\n```\n\n**Got:** Counts match the `total_skills`, `total_agents`, `total_teams` values in each registry header.\n\n**If fail:** If counts diverge from the header totals, the registry itself is out of sync. Note the discrepancy in the report but continue with the actual `- id:` entries as the source of truth.\n\n### Step 3: Audit Project-Level Symlinks\n\nCheck `.claude\u002Fskills\u002F*`, `.claude\u002Fagents`, `.claude\u002Fteams` in the current project directory.\n\n```bash\nPROJECT_CLAUDE=\".claude\"\n\n# --- Skills ---\n# Items on disk (excluding _template)\nPROJECT_SKILLS=$(ls \"$PROJECT_CLAUDE\u002Fskills\u002F\" 2>\u002Fdev\u002Fnull | grep -v '^_template$' | sort)\nPROJECT_SKILL_COUNT=$(echo \"$PROJECT_SKILLS\" | grep -c .)\n\n# Missing: in registry but not in project .claude\u002Fskills\u002F\nMISSING_PROJECT_SKILLS=$(comm -23 \u003C(echo \"$REGISTERED_SKILLS\") \u003C(echo \"$PROJECT_SKILLS\"))\n\n# Broken: symlink exists but target doesn't resolve\nBROKEN_PROJECT_SKILLS=$(find \"$PROJECT_CLAUDE\u002Fskills\u002F\" -maxdepth 1 -type l ! -exec test -e {} \\; -printf '%f\\n' 2>\u002Fdev\u002Fnull | sort)\n\n# Extraneous: in project but not in registry (and not external)\nEXTRA_PROJECT_SKILLS=$(comm -13 \u003C(echo \"$REGISTERED_SKILLS\") \u003C(echo \"$PROJECT_SKILLS\"))\n\n# --- Agents ---\nif [ -L \"$PROJECT_CLAUDE\u002Fagents\" ] || [ -d \"$PROJECT_CLAUDE\u002Fagents\" ]; then\n  PROJECT_AGENT_STATUS=\"OK\"\n  test -d \"$PROJECT_CLAUDE\u002Fagents\" || PROJECT_AGENT_STATUS=\"BROKEN\"\n  PROJECT_AGENT_COUNT=$(ls \"$PROJECT_CLAUDE\u002Fagents\u002F\"*.md 2>\u002Fdev\u002Fnull | wc -l)\nelse\n  PROJECT_AGENT_STATUS=\"MISSING\"\n  PROJECT_AGENT_COUNT=0\nfi\n\n# --- Teams ---\n# Teams are NOT symlinked. TeamCreate uses ~\u002F.claude\u002Fteams\u002F for runtime state.\n# A .claude\u002Fteams symlink is a misconfiguration — warn if found.\nif [ -L \"$PROJECT_CLAUDE\u002Fteams\" ]; then\n  PROJECT_TEAM_STATUS=\"MISCONFIGURED\"\n  PROJECT_TEAM_COUNT=0\n  # Stale symlink — should be removed to avoid collision with TeamCreate\nelse\n  PROJECT_TEAM_STATUS=\"OK\"\n  PROJECT_TEAM_COUNT=0\nfi\n```\n\n**Got:** Zero missing, zero broken. Extraneous items are classified and explained.\n\n**If fail:** If `.claude\u002F` does not exist at all, the project has no discovery setup. Note this and skip to global audit.\n\n### Step 4: Audit Global Symlinks\n\nCheck `~\u002F.claude\u002Fskills\u002F*` and `~\u002F.claude\u002Fagents`. Also check that `~\u002F.claude\u002Fteams` is NOT a symlink (it should be absent or a directory for TeamCreate runtime state).\n\n```bash\nGLOBAL_CLAUDE=\"$HOME\u002F.claude\"\n\n# --- Skills ---\nGLOBAL_SKILLS_ALL=$(ls \"$GLOBAL_CLAUDE\u002Fskills\u002F\" 2>\u002Fdev\u002Fnull | sort)\n\n# Classify each entry: almanac vs external\nALMANAC_GLOBAL_SKILLS=\"\"\nEXTERNAL_GLOBAL_SKILLS=\"\"\nfor item in $GLOBAL_SKILLS_ALL; do\n  target=$(readlink -f \"$GLOBAL_CLAUDE\u002Fskills\u002F$item\" 2>\u002Fdev\u002Fnull)\n  if [ -z \"$target\" ]; then\n    # Real directory (not a symlink) — external\n    EXTERNAL_GLOBAL_SKILLS=\"$EXTERNAL_GLOBAL_SKILLS $item\"\n  elif echo \"$target\" | grep -q \"^$ALMANAC_PATH\"; then\n    ALMANAC_GLOBAL_SKILLS=\"$ALMANAC_GLOBAL_SKILLS $item\"\n  else\n    EXTERNAL_GLOBAL_SKILLS=\"$EXTERNAL_GLOBAL_SKILLS $item\"\n  fi\ndone\n\n# Filter: _template is always extraneous for almanac content\nALMANAC_GLOBAL_SKILLS=$(echo \"$ALMANAC_GLOBAL_SKILLS\" | tr ' ' '\\n' | grep -v '^_template$' | grep -v '^$' | sort)\n\n# Missing: in registry but not in global almanac skills\nMISSING_GLOBAL_SKILLS=$(comm -23 \u003C(echo \"$REGISTERED_SKILLS\") \u003C(echo \"$ALMANAC_GLOBAL_SKILLS\"))\n\n# Broken: symlink exists but target doesn't resolve\nBROKEN_GLOBAL_SKILLS=$(find \"$GLOBAL_CLAUDE\u002Fskills\u002F\" -maxdepth 1 -type l ! -exec test -e {} \\; -printf '%f\\n' 2>\u002Fdev\u002Fnull | sort)\n\n# Stale almanac entries: in global almanac set but not in registry\nSTALE_GLOBAL_SKILLS=$(comm -13 \u003C(echo \"$REGISTERED_SKILLS\") \u003C(echo \"$ALMANAC_GLOBAL_SKILLS\"))\n\n# --- Agents ---\nif [ -L \"$GLOBAL_CLAUDE\u002Fagents\" ] || [ -d \"$GLOBAL_CLAUDE\u002Fagents\" ]; then\n  GLOBAL_AGENT_STATUS=\"OK\"\n  test -d \"$GLOBAL_CLAUDE\u002Fagents\" || GLOBAL_AGENT_STATUS=\"BROKEN\"\n  GLOBAL_AGENT_COUNT=$(ls \"$GLOBAL_CLAUDE\u002Fagents\u002F\"*.md 2>\u002Fdev\u002Fnull | wc -l)\nelse\n  GLOBAL_AGENT_STATUS=\"MISSING\"\n  GLOBAL_AGENT_COUNT=0\nfi\n\n# --- Teams ---\n# Teams are NOT symlinked. TeamCreate uses ~\u002F.claude\u002Fteams\u002F for runtime state.\n# A ~\u002F.claude\u002Fteams symlink is a misconfiguration — warn if found.\nif [ -L \"$GLOBAL_CLAUDE\u002Fteams\" ]; then\n  GLOBAL_TEAM_STATUS=\"MISCONFIGURED\"\n  GLOBAL_TEAM_COUNT=0\n  # Stale symlink — should be removed to avoid collision with TeamCreate\nelse\n  GLOBAL_TEAM_STATUS=\"OK\"\n  GLOBAL_TEAM_COUNT=0\nfi\n```\n\n**Got:** Zero missing almanac skills, zero broken. External content (peon-ping, etc.) is listed but not flagged as errors.\n\n**If fail:** If `~\u002F.claude\u002F` does not exist, the global hub is not set up. Refer to the [symlink-architecture guide](..\u002F..\u002Fguides\u002Fsymlink-architecture.md) for initial setup.\n\n### Step 5: Generate Audit Report\n\nProduce a summary table covering both layers.\n\n```markdown\n# Discovery Symlink Audit Report\n\n**Date**: YYYY-MM-DD\n**Almanac**: \u003Calmanac_path>\n**Scope**: both | project | global\n\n## Summary\n\n| Content | Registered | Project | Global (almanac) | Global (external) |\n|---------|------------|---------|-------------------|-------------------|\n| Skills  | N          | N       | N                 | N                 |\n| Agents  | N          | STATUS  | STATUS            | —                 |\n| Teams   | N          | STATUS  | STATUS            | —                 |\n\n## Issues\n\n### Missing (registered but no symlink)\n- Project skills: [list or \"none\"]\n- Global skills: [list or \"none\"]\n\n### Broken (symlink exists, target gone)\n- Project: [list or \"none\"]\n- Global: [list or \"none\"]\n\n### Extraneous\n- Stale almanac (in discovery but not registry): [list or \"none\"]\n- _template in discovery path: [yes\u002Fno]\n- External content (non-almanac): [list — informational only]\n```\n\n**Got:** A clear, actionable report. Zero issues means a clean bill of health.\n\n**If fail:** If report generation itself fails, output raw counts and lists to the console as fallback.\n\n### Step 6: Repair (Optional)\n\nIf `fix_mode` is `auto` or `interactive`, fix the issues found.\n\n**6a. Create missing project symlinks:**\n```bash\nfor skill in $MISSING_PROJECT_SKILLS; do\n  ln -s \"..\u002F..\u002Fskills\u002F$skill\" \"$PROJECT_CLAUDE\u002Fskills\u002F$skill\"\ndone\n```\n\n**6b. Create missing global symlinks:**\n```bash\nfor skill in $MISSING_GLOBAL_SKILLS; do\n  ln -s \"$ALMANAC_PATH\u002Fskills\u002F$skill\" \"$GLOBAL_CLAUDE\u002Fskills\u002F$skill\"\ndone\n```\n\n**6c. Remove broken symlinks:**\n```bash\n# Project\nfor broken in $BROKEN_PROJECT_SKILLS; do\n  rm \"$PROJECT_CLAUDE\u002Fskills\u002F$broken\"\ndone\n\n# Global\nfor broken in $BROKEN_GLOBAL_SKILLS; do\n  rm \"$GLOBAL_CLAUDE\u002Fskills\u002F$broken\"\ndone\n```\n\n**6d. Remove stale almanac entries:**\n```bash\n# Only remove items that target the almanac path but aren't in the registry\nfor stale in $STALE_GLOBAL_SKILLS; do\n  rm \"$GLOBAL_CLAUDE\u002Fskills\u002F$stale\"\ndone\n\n# Remove _template if present\nrm -f \"$GLOBAL_CLAUDE\u002Fskills\u002F_template\"\nrm -f \"$PROJECT_CLAUDE\u002Fskills\u002F_template\"\n```\n\n**6e. Fix missing directory symlinks (agents\u002Fteams):**\n```bash\n# Project agents\nif [ \"$PROJECT_AGENT_STATUS\" = \"MISSING\" ]; then\n  ln -s ..\u002Fagents \"$PROJECT_CLAUDE\u002Fagents\"\nfi\n\n# Project teams\nif [ \"$PROJECT_TEAM_STATUS\" = \"MISSING\" ]; then\n  ln -s ..\u002Fteams \"$PROJECT_CLAUDE\u002Fteams\"\nfi\n\n# Global agents\nif [ \"$GLOBAL_AGENT_STATUS\" = \"MISSING\" ]; then\n  ln -s \"$ALMANAC_PATH\u002Fagents\" \"$GLOBAL_CLAUDE\u002Fagents\"\nfi\n\n# Global teams\nif [ \"$GLOBAL_TEAM_STATUS\" = \"MISSING\" ]; then\n  ln -sf \"$ALMANAC_PATH\u002Fteams\" \"$GLOBAL_CLAUDE\u002Fteams\"\nfi\n```\n\n**Important:** Never remove items classified as external. These belong to other projects (e.g., peon-ping) and must be preserved.\n\n**Got:** All missing symlinks created, all broken symlinks removed, all stale almanac entries cleaned. External content untouched.\n\n**If fail:** If `ln -s` fails due to an existing file\u002Fdirectory at the target path (e.g., empty directory instead of symlink), remove the blocker first with `rmdir` (for empty dirs) or flag for manual review (for non-empty dirs).\n\n### Step 7: Verify\n\nRe-run the audit checks from Steps 3-4 to confirm repairs.\n\n```bash\necho \"=== Post-repair verification ===\"\necho \"Project skills: $(ls \"$PROJECT_CLAUDE\u002Fskills\u002F\" 2>\u002Fdev\u002Fnull | grep -v '^_template$' | wc -l)\"\necho \"Global skills (almanac): $(echo \"$ALMANAC_GLOBAL_SKILLS\" | wc -w)\"\necho \"Broken project: $(find \"$PROJECT_CLAUDE\u002Fskills\u002F\" -maxdepth 1 -type l ! -exec test -e {} \\; -print 2>\u002Fdev\u002Fnull | wc -l)\"\necho \"Broken global:  $(find \"$GLOBAL_CLAUDE\u002Fskills\u002F\" -maxdepth 1 -type l ! -exec test -e {} \\; -print 2>\u002Fdev\u002Fnull | wc -l)\"\necho \"Project agents: $PROJECT_AGENT_STATUS ($PROJECT_AGENT_COUNT .md files)\"\necho \"Global agents:  $GLOBAL_AGENT_STATUS ($GLOBAL_AGENT_COUNT .md files)\"\necho \"Project teams:  $PROJECT_TEAM_STATUS ($PROJECT_TEAM_COUNT .md files)\"\necho \"Global teams:   $GLOBAL_TEAM_STATUS ($GLOBAL_TEAM_COUNT .md files)\"\n```\n\n**Got:** Zero missing, zero broken. Counts match registered totals (for almanac content). External content listed separately.\n\n**If fail:** If issues remain after repair, report the specific failures. Common causes: permission errors on `~\u002F.claude\u002F`, NTFS path length limits on `\u002Fmnt\u002F` paths, or a non-empty directory blocking symlink creation.\n\n## Validation\n\n- [ ] Almanac path correctly identified and contains all three registries\n- [ ] Registry counts match `total_*` header values (or discrepancy noted)\n- [ ] Project-level skills, agents, and teams audited\n- [ ] Global-level skills, agents, and teams audited\n- [ ] External content (non-almanac) identified and excluded from issue counts\n- [ ] `_template` entries flagged as extraneous (never belongs in discovery paths)\n- [ ] Audit report generated with clear counts and actionable lists\n- [ ] If `fix_mode` is `auto`: all safe repairs applied, external content untouched\n- [ ] Post-repair verification confirms zero missing, zero broken\n\n## Pitfalls\n\n1. **Confusing external content with missing almanac content**: `~\u002F.claude\u002Fskills\u002F` may contain skills from other projects (e.g., peon-ping). Always check whether a symlink target is under the almanac path before classifying it as stale or extraneous.\n\n2. **Removing external content**: Never delete items that don't target the almanac. They belong to other projects and are intentional.\n\n3. **Symlinking `_template` directories**: Templates are scaffolding, not consumable content. The `_template` directory should never appear in `.claude\u002Fskills\u002F` or `.claude\u002Fagents\u002F`. Bulk sync scripts must explicitly skip it.\n\n4. **Stale `.claude\u002Fteams` symlink**: A `.claude\u002Fteams` symlink pointing to team definitions is a misconfiguration. Claude Code's `TeamCreate` uses `~\u002F.claude\u002Fteams\u002F` for runtime state (config.json, inboxes). If this path is a symlink to the almanac's `teams\u002F` directory, runtime artifacts will be written into the git-tracked repository. Remove any `.claude\u002Fteams` symlink found at project or global level.\n\n5. **Relative vs absolute paths**: Project-level skill symlinks use relative paths (`..\u002F..\u002Fskills\u002F\u003Cname>`). Global symlinks use absolute paths (`\u002Fpath\u002Fto\u002Falmanac\u002Fskills\u002F\u003Cname>`). Mixing these patterns causes breakage on moves.\n\n6. **Registry header vs actual count**: The `total_skills` field in the registry header may be stale if someone added entries without updating the count. Trust the actual `- id:` entries, not the header.\n\n## Related Skills\n\n- [repair-broken-references](..\u002Frepair-broken-references\u002FSKILL.md) -- general broken link and reference repair\n- [tidy-project-structure](..\u002Ftidy-project-structure\u002FSKILL.md) -- project directory organization\n- [create-skill](..\u002Fcreate-skill\u002FSKILL.md) -- includes symlink creation for new skills (Step 13)\n- [create-agent](..\u002Fcreate-agent\u002FSKILL.md) -- includes discovery verification (Step 10)\n- [create-team](..\u002Fcreate-team\u002FSKILL.md) -- team creation with registry integration\n",{"name":5,"locale":23,"license":14,"metadata":24,"translator":31,"description":32,"allowed-tools":33,"source_commit":34,"source_locale":35,"translation_date":36},"caveman-lite",{"tags":25,"author":26,"domain":27,"version":28,"language":29,"complexity":30},"maintenance, symlinks, discovery, claude-code, audit","Philipp Thoss","maintenance","1.0","shell","intermediate","Julius Brussee homage — caveman","Audit and repair Claude Code discovery symlinks for skills, agents, and teams. Compares registries against .claude\u002F directories at project and global levels, detects missing, broken, and extraneous symlinks, distinguishes almanac content from external projects, and optionally repairs gaps. Use after adding new skills or agents, after a repository rename or move, when slash commands stop working, or as a periodic health check.\n","Read Bash Grep Glob","82c77053","en","2026-04-19","master","f483e54f3ad5f202a77d45f2e57f8d970b71195f","skills_library\u002Faudit-discovery-symlinks",2,"https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills","https:\u002F\u002Fgithub.com\u002Froohe","yoou.link","2026-05-19 15:56:07",{"source":8,"skillName":5,"commands":46,"prompt":56,"zipAvailable":57},[47,50,53],{"tool":48,"command":49},"npx","npx skills add roohe\u002Fagentic-super-skills --skill audit-discovery-symlinks",{"tool":51,"command":52},"bunx","bunx skills add roohe\u002Fagentic-super-skills --skill audit-discovery-symlinks",{"tool":54,"command":55},"pnpm","pnpm dlx skills add roohe\u002Fagentic-super-skills --skill audit-discovery-symlinks","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Faudit-discovery-symlinks\u002FSKILL.md",true,[],[60,67,74,81,88,95],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M73D865CZME2FCMKA4PQM348","zarr-python","Chunked N-D arrays for cloud storage. Compressed arrays, parallel I\u002FO, S3\u002FGCS integration, NumPy\u002FDask\u002FXarray compatible, for large-scale scientific computing pipelines.","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fzarr-python\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M73D7Z64J4ABWZJD7P44XBBF","youtube-downloader","Download and process YouTube content for research. Use when: downloading competitor videos for analysis; extracting audio for podcasts; getting transcripts for content repurposing; archiving webinars; research content curation","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fyoutube-downloader\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M73D7K8778TGZV3GJFR3703D","yc-pitch-deck","Create a compelling startup pitch deck that follows the structure proven to raise billions from top investors. Master the YC and Sequoia formats that get founders funded. Use when: **Fundraising** to create investor pitch decks; **YC application** to structure your narrative; **Demo Day prep** to craft your 2-minute pitch; **Angel investors** to communicate your opportunity; **Partnership pitches** to structure compelling asks","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fyc-pitch-deck\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M73D70KJSE0E8Z28YMNNRT04","x-twitter-scraper","Use when the user needs X (Twitter) data or confirmation-gated X actions through Xquik: tweet search, user lookup, follower extraction, media download, monitoring, webhooks, MCP, SDKs, posting, likes, DMs, and profile updates. Requires a Xquik API key. Never ask for X login material.","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fx-twitter-scraper\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":18},"01M73D6ED01GV077R7K4NZNFZJ","write-vignette","Create R package vignettes using R Markdown or Quarto. Covers vignette setup, YAML configuration, code chunk options, building and testing, and CRAN requirements for vignettes. Use when adding a Getting Started tutorial, documenting complex workflows spanning multiple functions, creating domain-specific guides, or when CRAN submission requires user-facing documentation beyond function help pages.","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fwrite-vignette\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":18},"01M73D69YJR0BK3NFHE0CYG3EF","write-validation-documentation","Write IQ\u002FOQ\u002FPQ validation documentation for computerized systems in regulated environments. Covers protocols, reports, test scripts, deviation handling, and approval workflows. Use when validating R or other software for regulated use, preparing for a regulatory audit, documenting qualification of computing environments, or creating and updating validation protocols and reports for new or re-qualified systems.","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fwrite-validation-documentation\u002FSKILL.md",[],[]]