Agent Skills Reference

Reference for the skills generated by rill init --agent. The same set of skills is generated for every tool — only the file format and location differ.

Entry point

Each format includes an entry point that loads automatically when your agent starts working in the project:

Format	Entry point
Claude Code	`.claude/CLAUDE.md`
Cursor	`.cursor/rules/AGENTS.mdc` (always applied)
`AGENTS.md`	`AGENTS.md` at the project root

For Claude Code and AGENTS.md, the entry point instructs the agent to load the rill-development skill before making any changes, so the agent begins with an understanding of Rill's project structure and workflow. For Cursor, the development instructions live in the development.mdc rule instead, which Cursor applies on demand based on its description when you work on the project.

Skills

The remaining skills activate on demand based on what you ask the agent to do:

Skill	Description
`rill-development`	Overview of how to develop a Rill project: project structure, resource types, the resource DAG, and the development workflow. Loaded before any project changes.
`rill-analysis`	How to analyze data in a Rill project: discovering metrics views, running metrics queries, and presenting insights.
`rill-connector`	Detailed instructions and examples for developing connector resources, covering OLAP engines and data sources.
`rill-model`	Detailed instructions and examples for developing model resources, including SQL models, YAML models, incremental ingestion, and partitions.
`rill-metrics-view`	Detailed instructions and examples for developing metrics views, including measures, dimensions, and time series configuration.
`rill-explore`	Detailed instructions and examples for developing explore dashboard resources.
`rill-canvas`	Detailed instructions and examples for developing canvas dashboard resources and their components.
`rill-theme`	Detailed instructions and examples for developing theme resources.
`rill-rillyaml`	Detailed instructions and examples for developing the `rill.yaml` project file.

Each resource skill embeds the complete YAML schema for its resource type, generated from the same source as the project file reference. This lets your agent write valid configuration without guessing at property names.

File layout

Claude Code (`--agent claude`)

.claude/
├── CLAUDE.md
└── skills/
    ├── rill-development/SKILL.md
    ├── rill-analysis/SKILL.md
    ├── rill-connector/SKILL.md
    ├── rill-model/SKILL.md
    ├── rill-metrics-view/SKILL.md
    ├── rill-explore/SKILL.md
    ├── rill-canvas/SKILL.md
    ├── rill-theme/SKILL.md
    └── rill-rillyaml/SKILL.md
.mcp.json

Cursor (`--agent cursor`)

.cursor/
├── mcp.json
└── rules/
    ├── AGENTS.mdc
    ├── development.mdc
    ├── analysis.mdc
    └── resources/
        ├── connector.mdc
        ├── model.mdc
        ├── metrics_view.mdc
        ├── explore.mdc
        ├── canvas.mdc
        ├── theme.mdc
        └── rillyaml.mdc

AGENTS.mdc is marked alwaysApply: true; the other rules carry descriptions that let Cursor apply them automatically when relevant.

AGENTS.md (`--agent agentsmd`)

AGENTS.md
.agents/
└── skills/
    ├── rill-development/SKILL.md
    ├── rill-analysis/SKILL.md
    └── ... (same skills as Claude Code)
.mcp.json

MCP server configuration

Every format also writes an MCP configuration that registers Rill Developer's local MCP server as rill-developer at http://localhost:9009/mcp. If the file already contains other MCP servers, the Rill entry is added alongside them. See Connect the MCP server for details.

Entry point​

Skills​

File layout​

Claude Code (--agent claude)​

Cursor (--agent cursor)​

AGENTS.md (--agent agentsmd)​

MCP server configuration​

Related​