# Resource References

> skill: resource-references

- Skill: `gonzalezpazmonica/resource-references` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add gonzalezpazmonica/resource-references`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gonzalezpazmonica/resource-references/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gonzalezpazmonica (https://skillmd.com/u/gonzalezpazmonica)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/gonzalezpazmonica/resource-references

---


# skill: resource-references

## Name
resource-references

## Description
Define referenciable resources with @ notation for automatic context inclusion. Enables lazy-loaded resource resolution for seamless project data integration.

## Resource Schemas

### @azure:workitem://{id}
Fetches work item from Azure DevOps with automatic metadata inclusion.
- Example: `@azure:workitem://12345`
- Returns: work item title, description, status, assignee, tags

### @project:{name}
Loads project CLAUDE.md configuration and context.
- Example: `@project:savia`
- Returns: project overview, goals, tech stack, conventions

### @spec:{task-id}
Loads Software Design Document (SDD) specification for a task.
- Example: `@spec:ERA-67`
- Returns: requirements, design, acceptance criteria, technical details

### @team:{project}
Loads equipo.md with team structure and responsibilities.
- Example: `@team:savia`
- Returns: team members, roles, contact info, decision makers

### @rules:{project}
Loads reglas-negocio.md with business rules and constraints.
- Example: `@rules:savia`
- Returns: business logic, validation rules, domain constraints

### @memory:{topic}
Loads relevant memory entries by topic with semantic matching.
- Example: `@memory:deployment-strategy`
- Returns: relevant context, decisions, lessons learned

## Resolution Behavior

When an @ reference is found in user input or skill definition:
1. Detect reference pattern (lazy evaluation)
2. Resolve resource from approved sources
3. Include resolved content in context automatically
4. Cache result for session duration
5. Respect max 5 simultaneous resolutions limit

## Lazy Loading

Resources are only resolved when referenced, not during upfront parsing. This ensures:
- Minimal latency for unused references
- Efficient context utilization
- On-demand data fetching
- No unnecessary resource consumption

## Usage Examples

In skills and prompts:
```
Use @project:savia context and @rules:savia to validate decisions.
Check @spec:ERA-67 for detailed requirements before implementation.
Reference @team:savia to identify technical leads.
```

In user input:
```
"Build feature per @spec:ERA-65 with @rules:savia compliance"
```

## Limitations

- Unknown references generate warning, not error
- Only resolve from approved sources
- Max 5 simultaneous resolutions per session
- Cache valid for session duration only
- Circular references not supported

## Related

- resource-resolution rule
- /ref-list command
- /ref-resolve command

