agentskills.codes
SA

sample-with-references

by svelte-societyCodingSource

Uses on-demand loading of reference files to keep main documentation concise and efficient.

DocumentationMarkdown

Install

mkdir -p .claude/skills/sample-with-references && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/5008" && unzip -o skill.zip -d .claude/skills/sample-with-references && rm skill.zip

Installs to .claude/skills/sample-with-references

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Demonstrates progressive disclosure by linking to reference files. Use this pattern when your skill has detailed content that should load on-demand.
148 chars✓ has a “when” trigger
Beginner

Key capabilities

  • →Implement on-demand documentation loading
  • →Modularize large API references
  • →Structure documentation hierarchy
  • →Optimize AI context window usage
  • →Link related markdown files

How it works

Separates overview content from deep-dive references, loading supplementary files into the AI context only upon navigation or explicit request.

Inputs & outputs

You give it
Main SKILL.md file
You get back
Modular reference content loaded into context

When to use sample-with-references

  • →Modularize large API documentation
  • →Implement on-demand loading for tutorials
  • →Structure complex project reference files

About this skill

Sample Skill with References

This skill demonstrates progressive disclosure - keeping the main SKILL.md concise while linking to detailed reference files that Claude loads only when needed.

When to Use This Pattern

Use reference files when you have:

  • Detailed API documentation
  • Multiple workflows or domains
  • Large code examples
  • Configuration references

Quick Reference

For detailed patterns and examples, see REFERENCE.md.

How It Works

  1. Startup: Only name and description load into context
  2. Triggered: Claude reads this SKILL.md (~100-200 tokens)
  3. On-demand: Claude reads REFERENCE.md only if needed

This keeps token usage low while providing comprehensive documentation.

File Organization Tips

your-skill/
├── SKILL.md           # Overview and navigation (keep under 500 lines)
├── REFERENCE.md       # Detailed reference (loaded on-demand)
├── WORKFLOWS.md       # Step-by-step guides (loaded on-demand)
└── EXAMPLES.md        # Code examples (loaded on-demand)

Best Practices

  • Keep references one level deep (don't chain REFERENCE.md → ANOTHER.md)
  • Use descriptive filenames (not doc1.md, doc2.md)
  • Add a table of contents to files over 100 lines
  • Link with relative paths: [REFERENCE.md](REFERENCE.md)

When not to use it

  • →Simple, short documentation sets, Projects requiring monolithic file structures

Limitations

  • →Limited to one-level deep referencing
  • →Requires manual file structure maintenance

How it compares

Reduces token consumption by deferring the loading of detailed background information.

Compared to similar skills

sample-with-references side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
sample-with-references (this skill)17moNo flagsBeginner
markdown-to-html166moReviewBeginner
claude-md-enhancer19moReviewBeginner
deepinit15moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

More by svelte-society

View all by svelte-society →

admin-crud-page

svelte-society

Create admin dashboard pages with tables, forms, and actions

15

component-builder

svelte-society

Create UI components using tailwind-variants for type-safe styling. Use when creating or editing components in src/lib/ui/.

13

e2e-test-builder

svelte-society

Create Playwright E2E tests using Page Object Model pattern with database isolation

11

page-builder

svelte-society

Patterns for building list and detail pages with forms, filters, and data fetching

13

sample-basic

svelte-society

A minimal example skill demonstrating the required structure. Use this as a template when creating new skills.

15

svelte-code-writer

svelte-society

CLI tools for Svelte 5 documentation lookup and code analysis. MUST be used whenever creating or editing any Svelte component (.svelte) or Svelte module (.svelte.ts/.svelte.js). If possible, this skill should be executed within the svelte-file-editor agent for optimal results.

12

You might also like

markdown-to-html

github

Convert Markdown files to HTML similar to `marked.js`, `pandoc`, `gomarkdown/markdown`, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like `jekyll/jekyll`, `gohugoio/hugo`, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors.

1662

claude-md-enhancer

alirezarezvani

Analyzes, generates, and enhances CLAUDE.md files for any project type using best practices, modular architecture support, and tech stack customization. Use when setting up new projects, improving existing CLAUDE.md files, or establishing AI-assisted development standards.

113

deepinit

Yeachan-Heo

Deep codebase initialization with hierarchical AGENTS.md documentation

15

ability-generator

lofcz

This skill generates markdown skill templates to be later used.

13

website-maintainer

yamadashy

Use this skill when working on the Repomix documentation website in `website/` directory, including VitePress configuration, multi-language content, or translation workflows.

12

update-version

ZingerLittleBee

Update Dockerman version and changelog. Use when releasing a new version with changelog content in markdown format.

10

Search skills

Search the agent skills registry