With References

Apply with-references when testing reference file handling across all 11 tools, including copy-alongside, inline-bundle, and skip strategies.

ivy00johns Updated

File contents

Overview

This fixture skill exists to test the references handling contract. It ships with two reference files in its references/ directory: guide.md and glossary.md.

Reference Handling Matrix

Different tools treat the references directory differently. The test suite verifies the following behaviors:

  • Copy alongside: claude-code, antigravity, gemini-cli, opencode, openclaw, copilot copy references/ next to SKILL.md
  • Inline bundle: cursor, qwen, kimi append each reference file under a Reference header in the body
  • Skip: aider and windsurf skip references and emit a stderr note per skill

Why This Matters

Reference files can be large. The inline-bundle strategy is used by project-scoped tools where a directory layout is impractical. The skip strategy prevents the consolidated aider and windsurf single-file outputs from becoming unmanageable.

ivy00johns/Skill-Madness/tree/main/tests/installer/golden/antigravity/with-references commit 0befa1fbea

Frequently asked questions

npx skillmds@latest add ivy00johns/with-references