core-fix-skill-docs

Verify SKILL.md references against the references directory and fetch missing files.

51|6|Updated Mar 28, 2019
One-click install
npx skills add https://github.com/Mte90/dotfiles --skill core-fix-skill-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: core-fix-skill-docs
Source: https://github.com/Mte90/dotfiles/tree/main/.config/opencode/skills/core-fix-skill-docs
Command: npx skills add https://github.com/Mte90/dotfiles --skill core-fix-skill-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of checking for and fixing missing reference files within dynamic skills, ensuring documentation integrity.

Core Features & Use Cases

  • Automated Documentation Checks: Verifies the existence of all referenced files in SKILL.md against actual files in the references/ directory.
  • Automated Fixing: Can automatically fetch and create missing reference files from external sources like docs.rs.
  • Use Case: When deploying new skills or updating existing ones, this tool ensures all necessary documentation links are valid and files are present, preventing broken references for users.

Quick Start

Run /fix-skill-docs to check and fix documentation for all skills.

Frequently Asked Questions about core-fix-skill-docs

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

FAQPage Schema
How do I fix missing reference files in my skill documentation?

Checking missing skill documentation involves verifying SKILL.md references against the references directory to identify absent files. This validates that all documentation links resolve to actual files, preventing broken paths during skill deployment or updates.

How do I check for broken references in SKILL.md without automatically modifying files?

You can check for broken references without modifying files by passing the optional check-only argument. This validates the references directory against SKILL.md and reports missing documentation files without fetching or creating replacements.

Can I fetch missing Rust crate documentation from docs.rs to fix skill references?

Yes, you can fetch missing documentation from docs.rs using agent or inline modes. This automatically retrieves the required reference files from docs.rs and creates them in the references directory to resolve broken SKILL.md links.

How do I remove invalid references from SKILL.md automatically?

You can remove invalid references by passing the optional argument for removing them. This checks the references directory and cleans up SKILL.md by eliminating links to files that do not exist.

Does this documentation fixer work with agent and inline modes?

Yes, this documentation fixer supports agent and inline modes for fetching missing reference files. This allows flexible integration into automated pipelines or direct manual execution when resolving SKILL.md references.