Skip to content

roebi/aider-skills

Repository files navigation

aider-skills

Agent Skills integration for aider — inject structured skills into your AI pair programming sessions with zero aider changes.

CI PyPI Python License: MIT


Install

pip install aider-skills

Quickstart

# Inside an aider session:
/run aider-skills to-prompt ./my-skills

# Or at startup:
aider --read $(aider-skills tmpfile ./my-skills)

The model receives structured metadata about available skills and reads individual SKILL.md files on demand — exactly as the agentskills.io spec describes for filesystem-based agents.

Why

Aider has no plugin or hook system. aider-skills uses aider's own /run command and --read flag as integration points, requiring no fork and no changes to aider's internals.

Documentation

See docs/aider-integration.md for full usage, all three integration patterns, and skill authoring guidance.

Commands

Command What it does
to-prompt DIR... Print <available_skills> XML — use with /run
to-conventions DIR... Print markdown block — use with CONVENTIONS.md
tmpfile DIR... Write to temp file, print path — use with --read
list DIR... Human-readable list of discovered skills
validate DIR Validate a single skill directory

Related

  • agentskills.io — the Agent Skills specification
  • skills-ref — reference implementation this wraps
  • aider — AI pair programming in your terminal
  • cecli — aider fork with native skills support built in

License

MIT

About

Agent Skills integration for aider - inject structured skills into your AI pair programming sessions with zero aider changes.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors