/ Directory / Playground / prompt-architect
● Community ckelsoe ⚡ Instant

prompt-architect

by ckelsoe · ckelsoe/prompt-architect

Turn vague prompts into structured, expert-level prompts using 7 research-backed frameworks — CO-STAR, RISEN, RISE, TIDD-EC, RTF, CoT, CoD.

Prompt Architect transforms short, ambiguous prompts into structured versions using 7 named frameworks. Good for team-wide prompt consistency and for getting more reliable Claude output on complex tasks. Works in Claude Code; outputs can be saved as reusable templates.

Why use it

Key features

Live Demo

What it looks like in practice

prompt-architect-skill.replay ▶ ready
0/0

Install

Author repository · Claude Skills documentation

Use Cases

Real-world ways to use prompt-architect

How to turn a vague prompt into a structured one

👤 Anyone frustrated by inconsistent Claude output ⏱ ~10 min beginner

When to use: You keep asking Claude the same kind of question and getting different-quality answers.

Flow
  1. Submit the vague prompt
    Use prompt-architect. My current prompt: 'write something for our launch email'. Make this structured.✓ Copied
    → Framework recommendation + structured version
  2. Pick + refine
    Use CO-STAR. Tone: confident but human; audience: B2B SaaS founders; objective: drive webinar signups.✓ Copied
    → CO-STAR structured prompt with all fields filled
  3. Save as template
    Save this as template 'launch-email-costar'.✓ Copied
    → Template persisted

Outcome: A reusable structured prompt that produces consistent output.

Pitfalls
  • Framework overhead for simple tasks — For short, one-off tasks, Prompt Architect will recommend staying simple rather than forcing a framework

Pick the right framework for a specific task shape

👤 Practitioners deciding CoT vs CO-STAR vs RISEN ⏱ ~15 min intermediate

When to use: You're not sure which framework fits.

Flow
  1. Describe the task
    Task: synthesize 20 customer interview notes into themes. Which framework, and why?✓ Copied
    → Framework recommendation with reasoning
  2. Try an alternative
    Now show the same task structured with CoT vs CO-STAR; compare.✓ Copied
    → Side-by-side with tradeoff notes

Outcome: Confident framework choice for the task shape.

Build a team-shared prompt pack

👤 Prompt engineers writing house prompts for a team ⏱ ~60 min intermediate

When to use: You want every teammate to get consistent Claude behavior on the same tasks.

Flow
  1. Start a session
    I need 8 team prompts: lead-qualification, onboarding-email, refund-decision, ... Walk me through each with the right framework.✓ Copied
    → Framework-per-task + drafts

Outcome: A versioned, shareable prompt pack.

Combinations

Pair with other MCPs for X10 leverage

prompt-architect-skill + claude-code-skill-factory-skill

Architect prompts, then Factory packages them as a skill

Use prompt-architect for 5 prompts, then /build prompts with Factory to export them.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
Transform prompt vague prompt, framework? Upgrading a prompt Claude tokens
Recommend framework task description Unsure which to use Claude tokens
Save template name, prompt When the prompt works well 0
Export pack templates[] Team sharing 0

Cost & Limits

What this costs to run

API quota
None
Tokens per call
2-5k per prompt transformation
Monetary
Free
Tip
Once a template works, reuse it — don't re-architect every time.

Security

Permissions, secrets, blast radius

Credential storage: No credentials
Data egress: Prompt drafts go to Claude

Troubleshooting

Common errors and fixes

Framework feels like overkill for simple tasks

Prompt Architect should recommend minimal structure; if it doesn't, explicitly request 'minimal structure'

Output more verbose than original prompt

Structured prompts can be longer but should produce more consistent output; measure consistency rather than length

Alternatives

prompt-architect vs others

AlternativeWhen to use it insteadTradeoff
Anthropic's prompt generatorYou want Anthropic's own suggestions for Claude promptsFewer frameworks surfaced by name

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills

Continue exploring

Related tools and workflows

Choose another guide for your workflow, or explore a collection.

Browse all topic collections → · See 29 new official additions →