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.
How it works
A skill is a SKILL.md folder that teaches a coding agent
a repeatable practice — here, how to build with poetry. The skills below are projected live
from the same sources bin/rails g poetry:skill installs,
and the discovery index at
/.well-known/agent-skills/index.json
lists each one with a payload url and a sha256: digest
that a conformant installer verifies before writing anything to disk. One command installs
the whole catalog:
npx skills add https://poetryui.com/agent-skills
Add --skill <name> to skip the prompt,
-a <agent> to target one of 70+ agents, and
-g for a global install. Repo-based install paths
(a Claude plugin marketplace, gh skill) arrive when the
source repositories are public.
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.
npx skills add https://poetryui.com/agent-skills --skill poetry
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.
npx skills add https://poetryui.com/agent-skills --skill poetry-design
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.
npx skills add https://poetryui.com/agent-skills --skill poetry-component
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.
npx skills add https://poetryui.com/agent-skills --skill poetry-docs-site
curl -fsSL https://poetryui.com/agent-skills/poetry-docs-site/SKILL.md --create-dirs -o ~/.claude/skills/poetry-docs-site/SKILL.md
In a Rails app with Poetry
Skip the network entirely: bin/rails g poetry:skill
installs the poetry, poetry-design, and poetry-component skills from the gems
themselves — the same files served here, generated from the same registry.