Skip to content

feat: add on-demand skill loading for agents#17

Open
ericlake wants to merge 1 commit intomainfrom
feat/agent-skills
Open

feat: add on-demand skill loading for agents#17
ericlake wants to merge 1 commit intomainfrom
feat/agent-skills

Conversation

@ericlake
Copy link
Copy Markdown
Contributor

@ericlake ericlake commented Mar 9, 2026

Implement the Agent Skills specification for Aura. Skills are directories containing a SKILL.md file with YAML frontmatter. The LLM sees a catalog of available skills in its system prompt and calls a load_skill tool to retrieve detailed instructions only when needed, keeping the base prompt small.

  • Add SkillsConfig and LocalSkillSource to aura-config with spec-compliant name validation (1-64 chars, lowercase alphanumeric
    • hyphens, must match directory name)
  • Add skill discovery scanning source directories for SKILL.md files with AURA_SKILLS_DIR env var fallback
  • Add LoadSkillTool implementing rig::tool::Tool for on-demand loading of skill instructions and reference files
  • Inject skill catalog into agent system prompt during build
  • Thread config_dir through web server to resolve relative skill paths
  • Add /app/skills directory and AURA_SKILLS_DIR env var to Dockerfile
  • Sort reference files by name for deterministic output
  • Warn (without truncating) when skill content exceeds 512KB
  • Add unit tests for name validation, frontmatter parsing, and skill discovery (dedup, name mismatch, relative paths)

Ref: LOG-23254

@ericlake ericlake requested a review from a team March 9, 2026 17:10
@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 9, 2026

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@ericlake
Copy link
Copy Markdown
Contributor Author

ericlake commented Mar 9, 2026

I have read the CLA Document and I hereby sign the CLA

@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 9, 2026

Test results for Rust

335 tests  +30   335 ✅ +30   6s ⏱️ -1s
  4 suites ± 0     0 💤 ± 0 
  1 files   ± 0     0 ❌ ± 0 

Results for commit 00070b7. ± Comparison against base commit 73b3442.

@ericlake ericlake force-pushed the feat/agent-skills branch from 00070b7 to 43f7692 Compare March 10, 2026 20:27
@ericlake ericlake force-pushed the feat/agent-skills branch from 43f7692 to c6f6a6c Compare March 10, 2026 21:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant