Refactor AGENTS.md files into linked documents using progressive disclosure.
npx skills add https://github.com/jscraik/Agent-Skills --skill agents-md-jscraik
Please help me install this Agent Skill. Skill: agents-md Source: https://github.com/jscraik/Agent-Skills/tree/main/product/docs/agents-md Command: npx skills add https://github.com/jscraik/Agent-Skills --skill agents-md-jscraik
This Skill addresses the challenge of maintaining large, complex, and potentially contradictory documentation for AI agents by refactoring it into a more manageable and discoverable format.
AGENTS.md file concise and routing detailed instructions to linked files.AGENTS.md file becomes a lengthy monolith, use this skill to split it into a high-level overview and detailed guides for specific commands, ensuring clarity and reducing cognitive load for users.Use the agents-md skill to refactor the AGENTS.md file for progressive disclosure.
High-intent search queries and answers about installing and using this skill.
Refactoring a lengthy AGENTS.md file involves splitting it into a concise root overview and linked detailed guides. This progressive disclosure approach ensures clarity, reduces duplication, and organizes instructions for specific commands.
To fix contradictory instructions in your documentation, use a refactoring process that detects and flags conflicting guidelines. It then reorganizes the content into linked files to eliminate redundancy and resolve contradictions.
Splitting a large AGENTS.md file involves breaking the monolith into a high-level overview and detailed guides for specific commands. This ensures the root guidance remains minimal while routing detailed instructions to linked documents.
You should refactor your AI agent markdown documentation when it becomes a lengthy monolith with duplicated or contradictory instructions. This is necessary when the file size causes cognitive overload and hinders discoverability.
Yes, progressive disclosure works for resolving markdown redundancy by keeping the root AGENTS.md file minimal and routing detailed instructions to linked documents. It actively flags contradictions and reduces duplicated content across the documentation.
antoine-bouteillerRefactor monolithic agent instruction files into linked Markdown documents.
Likas07Refactors monolithic agent instruction files into a root file and linked Markdown documents.
bordenetValidate and verify Markdown links in documentation before publishing.
wanyusheng63-altSplit large Markdown documents into smaller files by heading structure.