# Pawrly agent skills

> Agent skills for using Pawrly: inspect available data, run SQL, connect new sources, save useful results, and define approved business metrics.

Pawrly ships a plugin for Claude Code and Codex that bundles these skills plus the Pawrly MCP server (`pawrly mcp-stdio`), so an agent can read your workspace the moment it's installed.

## Prerequisites
The `pawrly` binary must be on the agent's PATH, and a `pawrly.yaml` must be discoverable (via `PAWRLY_CONFIG` / `--config` or the working directory). Install the binary with `curl -fsSL https://pawrly.dev/install.sh | sh` — see https://pawrly.dev/install.md.

## Skills
### pawrly
Entrypoint for reads. Find sources, inspect tables, run SQL, ask approved business questions, and save useful results for later.

SKILL.md: https://github.com/CITGuru/pawrly/tree/main/plugins/pawrly/skills/pawrly/SKILL.md

### pawrly-add-source
Connect a new API, file, MCP server, database, warehouse, or lakehouse by adding it to pawrly.yaml.

SKILL.md: https://github.com/CITGuru/pawrly/tree/main/plugins/pawrly/skills/pawrly-add-source/SKILL.md

### pawrly-semantic-model
Define approved business metrics, fields, joins, and required filters so agents do not invent business logic.

SKILL.md: https://github.com/CITGuru/pawrly/tree/main/plugins/pawrly/skills/pawrly-semantic-model/SKILL.md

### pawrly-materialize
Save a query result, local file, or remote URL as a table the agent can reuse later.

SKILL.md: https://github.com/CITGuru/pawrly/tree/main/plugins/pawrly/skills/pawrly-materialize/SKILL.md

The `pawrly` skill is the entrypoint for read tasks. It can list sources, search tables, describe columns, run SQL, ask approved metric questions, and save results. The other skills help edit `pawrly.yaml` when a source or business definition is missing.

## Install the plugin
The plugin and its manifests live in the repository — add it as a plugin to load all four skills and the bundled MCP server:
- Plugin directory: https://github.com/CITGuru/pawrly/tree/main/plugins/pawrly
- Claude Code manifest: https://github.com/CITGuru/pawrly/tree/main/plugins/pawrly/.claude-plugin/
- Codex manifest: https://github.com/CITGuru/pawrly/tree/main/plugins/pawrly/.codex-plugin/

## Links
- Repository: https://github.com/CITGuru/pawrly
- Install guide: https://pawrly.dev/install.md
- Machine-readable index: https://pawrly.dev/llms.txt