prompt-engineer

Refine SKILL.md files, agent definitions, and slash commands using structured prompt patterns and evaluation-driven refinement loops.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/yiwei79/root-azoth --skill prompt-engineer-yiwei79
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prompt-engineer
Source: https://github.com/yiwei79/root-azoth/tree/main/.opencode/skills/prompt-engineer
Command: npx skills add https://github.com/yiwei79/root-azoth --skill prompt-engineer-yiwei79

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing and maintaining agent instructions, skill definitions, and slash commands often produces vague, unreliable prompts that degrade agent behavior over time. This Skill provides structured patterns, quality checklists, and an evidence-driven refinement loop to keep instruction surfaces clear and testable. ## Core Features & Use Cases - Prompt Structure Patterns: Apply reusable templates like Role-Context-Task-Format (RCTF), chain-of-thought gates, few-shot rubrics, and Azoth effect labels for write-capable instructions. - Instruction Quality Checklist: Validate prompts against clarity, reliability, boundary, and testability criteria before finalizing them. - L2 Auto-Refinement: Consume machine-readable evaluation evidence from .azoth/memory/l2-refinement-evidence.jsonl to propose A/B instruction variants for human approval. - Use Case: When evaluation data shows an agent repeatedly failing a task, use this Skill to read the L2 evidence records, hypothesize an instruction fix, and propose a refined SKILL.md variant for human review. ## Quick Start Ask the agent to review and improve a specific SKILL.md or slash command file using the prompt-engineer patterns and quality checklist.

Frequently Asked Questions about prompt-engineer

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

FAQPage Schema
How do I write a good SKILL.md file for an AI agent?▼

Structure it with YAML frontmatter containing name and description, followed by an overview, when-to-use triggers, process patterns, a copy-paste template, references, and best practices. Apply the clarity, reliability, boundary, and testability checklist before finalizing.

How to improve agent prompts based on evaluation results?▼

Use the L2 refinement loop: collect evaluation data, identify failure patterns, hypothesize an instruction improvement, generate A/B variants, and evaluate them against the same criteria. Always propose the winning variant to a human rather than auto-applying it.

What is the Role-Context-Task-Format prompt pattern?▼

RCTF is a foundational instruction structure with four sections: Role defines who the agent is, Context provides needed background, Task gives specific actionable instructions, and Format specifies the expected output structure.

Can prompt refinements be applied automatically without approval?▼

No. Refinements to skills or agent definitions are always propose-only and require human approval. The refinement rules require a minimum of three evaluations before proposing a change, and governance-touching changes need the full pipeline.

What is the azoth_effect label in slash commands?▼

It is a YAML frontmatter field declaring whether a command can trigger writes: read for analysis-only, write when file mutation is in the default path, or mixed when human approval is required before any write.