# Agent Skills

The installable skills catalog: what each skill teaches, served live with a discovery index (agentskills.io schema, sha256 digests) so npx skills, a curl one-liner, or bin/rails g poetry:skill drops the same SKILL.md set into any agent's skills directory.

The discovery index at [/.well-known/agent-skills/index.json](/.well-known/agent-skills/index.json) (agentskills.io discovery schema 0.2.0) lists every skill with a payload url and a `sha256:` digest a conformant installer verifies before writing anything. In a Rails app with Poetry, `bin/rails g poetry:skill` installs the poetry, poetry-design, and poetry-component skills without touching the network.

## poetry

Build Rails views with the poetry component library: helper contracts, options, slots, blocks, and the check workflow. Use whenever writing or editing ERB/UI in an app that has poetry installed.

Files: `SKILL.md`, `references/blocks.md`, `references/charts.md`, `references/chat.md`, `references/data.md`, `references/deciding.md`, `references/feedback.md`, `references/forms.md`, `references/foundations.md`, `references/layout.md`, `references/navigation.md`, `references/overlays.md`.

Install: `npx skills add https://poetryui.com/agent-skills --skill poetry` (add `-a <agent>` to target one of 70+ agents, `-g` for a global install). Dependency-free: `mkdir -p ~/.claude/skills/poetry && curl -fsSL https://poetryui.com/agent-skills/poetry.tar.gz | tar -xz -C ~/.claude/skills/poetry`.

## poetry-design

Design guidance for building poetry UIs: theme selection, page composition (macrostructure, hierarchy, containment, status color), the visual audit of a finished screen, and studying a brand into a DESIGN.md. Load this WHENEVER building, composing, or restyling a page, screen, dashboard, or view with poetry - alongside the poetry usage skill, before composing - not only when the task mentions design.

Files: `SKILL.md`, `references/audit.md`, `references/compose.md`, `references/figma.md`, `references/paper.md`, `references/study.md`, `references/theme.md`.

Install: `npx skills add https://poetryui.com/agent-skills --skill poetry-design` (add `-a <agent>` to target one of 70+ agents, `-g` for a global install). Dependency-free: `mkdir -p ~/.claude/skills/poetry-design && curl -fsSL https://poetryui.com/agent-skills/poetry-design.tar.gz | tar -xz -C ~/.claude/skills/poetry-design`.

## poetry-component

Author and audit poetry components: the canonical class anatomy (section order every component follows), the documentation standard (YARD + projected strings), and the audit checklist. Load this WHENEVER creating a new component that inherits from Poetry::Core::Component, extending an existing component family, or reviewing a component file for structure and documentation - the anatomy is the contract that keeps every component readable the same way.

Files: `SKILL.md`, `references/anatomy.md`, `references/checklist.md`, `references/documentation.md`.

Install: `npx skills add https://poetryui.com/agent-skills --skill poetry-component` (add `-a <agent>` to target one of 70+ agents, `-g` for a global install). Dependency-free: `mkdir -p ~/.claude/skills/poetry-component && curl -fsSL https://poetryui.com/agent-skills/poetry-component.tar.gz | tar -xz -C ~/.claude/skills/poetry-component`.

## poetry-docs-site

Navigate the poetry documentation site as an agent - where the machine-readable catalog, markdown mirrors, registry, and skills live, and how to install components from here.

Files: `SKILL.md`.

Install: `npx skills add https://poetryui.com/agent-skills --skill poetry-docs-site` (add `-a <agent>` to target one of 70+ agents, `-g` for a global install). Dependency-free: `curl -fsSL https://poetryui.com/agent-skills/poetry-docs-site/SKILL.md --create-dirs -o ~/.claude/skills/poetry-docs-site/SKILL.md`.