THE SACRED SCROLLS

A Skill is a structured prompt package — a precise set of instructions that teaches an AI agent how to perform a specific task. Unlike vague prompts, Skills have defined boundaries, constraints, and expected outputs. Install them with a single command and reuse them forever.

PromptMentor uses Socratic questioning to refine your skill idea before generating it. By asking "What tools?", "What constraints?", and "Who consumes this?", the Oracle crafts skills that are precise, not generic. The unexamined prompt is not worth using.

Every skill is installable via npx: npx skills add promptmentor/<skill-slug> This works with any npx-compatible system — Claude Code, Hermes Agent, or your own pipeline. No configuration, no API keys, no MCP tokens. Just run and go.

Skills follow a standard YAML frontmatter + markdown structure: --- name: reviewing-pull-requests description: Use when [situation or symptom] --- ## Overview — core invariant in 2 sentences ## When to Use — specific symptoms and contraindications ## Core Pattern — table, before/after, or sequence ## Implementation — numbered steps with real commands <HARD-GATE> — absolute prohibition, no exceptions ## Red Flags — never-do actions ## Common Mistakes — mistake/fix table The Oracle enforces this structure. The description must always start with "Use when" and describe a trigger condition, never a workflow summary.

After forging a skill, you can publish it to The Agora — PromptMentor's public library. Published skills appear in search results and can be downloaded by other seekers. Your name lives on the scroll as its creator. Skills can be unpublished at any time.

Free accounts get 3 skill downloads per calendar month. Seeker ($12/mo) removes this limit and adds priority generation, custom namespaces, and a private vault. Sage ($49/mo) includes everything plus API access, bulk generation, team sharing, and white-label exports.