skill-load-tips

What problem does it solve?

It fixes skills where the agent mostly reads only the SKILL.md body and ignores the load-bearing content in references, leading to shallow, inconsistent, or incorrect results.

Core Features & Use Cases

• Required Reading Router: Adds a task-to-file mapping so the agent knows exactly which reference files must be read for each task type.
• Hard STOP directives: Replaces soft prompts with imperative “STOP. Read … in full” instructions tied to specific operating steps.
• Gist tripwire trimming: Shrinks duplicated inline checklists into brief tripwires while forcing the agent to load the full reference instead.
• One-level reference flattening: Ensures references link directly from SKILL.md (not from other reference files) and adds a top “Contents” section for large reference files.
• Use Case: Audit a long-running production skill that “feels right” in the body but underperforms because the agent never fans out into references; refactor it so reference files are reliably loaded and used as the source of truth.

Quick Start

Ask an agent to audit the target skill by diagnosing which reference files are likely never loaded and then refactor its SKILL.md by adding a router, STOP directives, and trimmed tripwire inline content.