Install AI agent skills for Claude Code, Codex, Cursor, and 50+ other agents to help build Lunar collectors, policies, and SQL queries.
The earthly/skills repository provides AI agent skills for working with Lunar. These skills enable AI assistants to help you build custom plugins, edit your lunar-config.yml, and query Lunar's data model.
Create Lunar collector plugins (Bash scripts) that gather SDLC metadata
Create Lunar cataloger plugins (Bash scripts) that build the software catalog from external systems or repo signals
Create Lunar policy plugins (Python scripts) that enforce engineering standards
Edit lunar-config.yml — wire together components, domains, collectors, policies, catalogers, and initiatives
Craft SQL queries against Lunar's data model (components, checks, policies, domains, PRs)
Install with the skills CLI:
# Install all Lunar skills globally
npx skills add earthly/skills -g
# Or install a specific skill globally
npx skills add earthly/skills -g --skill lunar-policyThe CLI auto-detects which coding agents you have installed (Claude Code, Codex, Cursor, and 50+ more) and copies the skills to the right location. See the skills CLI docs for more commands like list, update, and remove.
Drop -g to install into the current project's .claude/skills/ (or equivalent) instead — useful if you want to commit the skills into a shared team repo.
These skills are designed to be used with AI agents that support the Claude/Codex skill format. Each skill contains:
SKILL.md - Main instructions and quick-start guide
references/ - Curated documentation for the AI to consult as needed
Once installed, your AI assistant will automatically detect and use these skills when you ask it to build a Lunar plugin, edit your config, or query the SQL API.
Bash SDK - Manual reference for building collectors and catalogers
Python SDK - Manual reference for building policies
lunar-config.yml - Manual reference for the configuration file
SQL API - Manual reference for querying Lunar data
lunar-lib Repository - Reference collectors, catalogers, and policies
Last updated