Prompt Authoring Guide Skill

Prompt Authoring Guide

This skill provides patterns for creating prompts in the claude-prompts-mcp system.

CAGEERF Methodology

Prompts follow the C.A.G.E.E.R.F framework:

| Phase | Purpose | Output | |-------|---------|--------| | Context | Gather domain knowledge | Situational understanding | | Analysis | Break down the problem | Structured insights | | Goals | Define success criteria | Measurable objectives | | Execution | Implement the solution | Concrete deliverables | | Evaluation | Validate against goals | Quality assessment | | Refinement | Iterate based on feedback | Improved output | | Finalization | Complete and document | Final deliverable |

Prompt Structure

---
id: my-prompt
name: My Prompt
description: What this prompt accomplishes
category: development
execution_hint: single  # or 'chain'
arguments:
  - name: input
    type: string
    description: Primary input
---
system_message: |
  You are an expert at [domain].

user_message_template: |
  Task: {input}

  Requirements:
  - Requirement 1
  - Requirement 2

Chain Definition

Chains connect prompts with -->:

>>analyze --> >>design --> >>implement --> >>test

Chain features:

Sequential execution with context passing
Gate validation between steps
Resume capability with chain_id

Quality Gates

Gates validate output quality:

id: code-quality
name: Code Quality Gate
severity: high
criteria:
  - "Code follows established patterns"
  - "Error handling is comprehensive"
pass_criteria:
  - "All criteria met with evidence"

Severity levels: critical | high | medium | low

Creating New Prompts

Use the resource_manager tool:

resource_manager({
  resource_type: "prompt",
  action: "create",
  id: "new-prompt",
  name: "New Prompt",
  description: "Purpose",
  category: "development",
  system_message: "...",
  user_message_template: "..."
})

Best Practices

Clear objectives: Define what success looks like
Structured output: Specify expected format
Validation criteria: Include checkable requirements
Composability: Design prompts that chain well
Gate integration: Add quality checks for critical outputs

Agent Skills: Prompt Authoring Guide

Skill Files