Agent skill

A short, stable skill that teaches agents to assemble Pegma packages instead of regenerating sessions, identity, rate limits, mail, and audit. Package inventories and versions live incatalog.json — not in the skill.

Canonical raw markdown (copy or fetch):https://pegma.dev/skill.md

Install notes

There is no single universal skill registry. Use whichever path your tool supports; the document is plain markdown.

Project rules / skills directory

Copy the skill into the project agent directory under a name your tool expects (examples: .grok/skills/pegma/SKILL.md,.claude/skills/pegma/SKILL.md, .agents/skills/pegma/SKILL.md, or a project AGENTS.md / rules file that points at the same text).

mkdir -p .grok/skills/pegma
curl -fsSL https://pegma.dev/skill.md -o .grok/skills/pegma/SKILL.md
# or
mkdir -p .claude/skills/pegma
curl -fsSL https://pegma.dev/skill.md -o .claude/skills/pegma/SKILL.md

Many tools treat a directory containing SKILL.md (with YAML frontmatter) as an installable skill. Keep the frontmatter; do not strip it.

Paste into system / custom instructions

Open skill.md, copy the body into the agent’s custom instructions or project rules. Prefer linking the catalog URL so the agent re-fetches facts instead of caching versions in the prompt.

Plugin / marketplace wrappers

If your environment uses a plugin that only differs by install path, wrap this same markdown. Do not fork package facts into the wrapper — point athttps://pegma.dev/catalog.json.

What the skill teaches

Assembly over generation
Explicit composition root; pin exact 0.x versions from the catalog
Refusals as hard constraints
Lookup: catalog → component → green recipe → fixture source
Prove with types and tests

Related:catalog.json ·examples ·llms.txt ·stack