prompt-architect

Create and refine prompts, system instructions, and CLAUDE.md principles.

Updated Jan 4, 2026
One-click install
npx skills add https://github.com/retz8/iris --skill prompt-architect-retz8
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prompt-architect
Source: https://github.com/retz8/iris/tree/main/.claude/skills/prompt-architect
Command: npx skills add https://github.com/retz8/iris --skill prompt-architect-retz8

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams create and refine production-ready prompts, system instructions, and CLAUDE.md principles. It reduces iteration time by providing a structured approach to transforming verbose prompts, adding patterns, and optimizing token usage, while preserving domain knowledge and intent.

Core Features & Use Cases

  • Prompt creation and enhancement: Generate concise, effective prompts for AI agents, with attention to persona, tone, and constraints.
  • Principle file structuring: Organize CLAUDE.md principles and agent identity into repeatable templates.
  • Prompt optimization techniques: Apply chain-of-thought framing, few-shot patterns, and ReAct/CoT techniques to improve outcomes.
  • Persona and voice management: Define agent soul, thinking_style, tensions, and boundaries to align behavior across tasks.
  • Refactor and compress prompts: Transform voice and structure while preserving content depth and domain knowledge.
  • Real-world example: Given a verbose prompt about product strategy, produce a concise, executable agent prompt with explicit roles and decision criteria.

Quick Start

Provide an initial "prompt-architect" prompt to rewrite a long, ambiguous instruction into a precise, executable prompt, preserving domain knowledge and intent.

Frequently Asked Questions about prompt-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I refine prompts to make verbose instructions more concise and executable?

To refine prompts, you transform verbose instructions into precise, executable system prompts while preserving domain knowledge and intent. This involves structuring persona definitions, adding patterns, and optimizing token usage for AI-agent design tasks.

What is the best way to structure CLAUDE.md principles for agent identity?

Structuring CLAUDE.md principles involves organizing agent identity, thinking style, and boundaries into repeatable templates. This aligns agent behavior across tasks by defining persona, voice, and constraints within a structured principle file format.

How do I apply chain-of-thought and few-shot patterns to my AI agent prompts?

Applying chain-of-thought and few-shot patterns involves framing prompts with explicit reasoning steps and providing example-based guidance. These prompt-engineering techniques improve outcomes by guiding the agent's thinking process and expected response format.

Can I compress a long system prompt without losing domain knowledge depth?

Yes, you can compress system prompts by transforming voice and structure while explicitly preserving content depth and domain knowledge. Prompt optimization reduces token usage and iteration time without sacrificing the original intent or domain context.

When should I use ReAct techniques in prompt engineering?

Use ReAct techniques in prompt engineering when your AI agent needs to interleave reasoning with actionable steps. This approach supports complex agent workflows by combining chain-of-thought framing with explicit action execution to achieve desired outcomes.

How do I align system instructions with specific agent workflows and decision criteria?

Aligning system instructions with workflows requires defining explicit roles, persona boundaries, and decision criteria within the prompt. This ensures the agent executes tasks according to structured constraints and specific operational requirements.