AI Skills

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.

Available Skills

Skill	Description
lunar-collector	Create Lunar collector plugins (Bash scripts) that gather SDLC metadata
lunar-cataloger	Create Lunar cataloger plugins (Bash scripts) that build the software catalog from external systems or repo signals
lunar-policy	Create Lunar policy plugins (Python scripts) that enforce engineering standards
lunar-config	Edit lunar-config.yml — wire together components, domains, collectors, policies, catalogers, and initiatives
lunar-sql	Craft SQL queries against Lunar's data model (components, checks, policies, domains, PRs)

Installation

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-policy

The 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.

Usage

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.

Related Resources

• 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