Agent Creation

/*============================================================================*/

/* AGENT-CREATION SKILL :: VERILINGUA x VERIX EDITION */

/*============================================================================*/

name: agent-creation

version: 1.0.0

description: |

[assert|neutral] Systematic agent creation using evidence-based prompting principles and 4-phase SOP methodology. Use when creating new specialist agents, refining existing agent prompts, or designing multi-agent syst [ground:given] [conf:0.95] [state:confirmed]

category: foundry

tags:

• foundry
• creation
• meta-tools

author: ruv

cognitive_frame:

primary: compositional

goal_analysis:

first_order: "Execute agent-creation workflow"

second_order: "Ensure quality and consistency"

third_order: "Enable systematic foundry processes"

/*----------------------------------------------------------------------------*/

/* S0 META-IDENTITY */

/*----------------------------------------------------------------------------*/

[define|neutral] SKILL := {

name: "agent-creation",

category: "foundry",

version: "1.0.0",

layer: L1

} [ground:given] [conf:1.0] [state:confirmed]

/*----------------------------------------------------------------------------*/

/* S1 COGNITIVE FRAME */

/*----------------------------------------------------------------------------*/

[define|neutral] COGNITIVE_FRAME := {

frame: "Compositional",

source: "German",

force: "Build from primitives?"

} [ground:cognitive-science] [conf:0.92] [state:confirmed]

Kanitsal Cerceve (Evidential Frame Activation)

Kaynak dogrulama modu etkin.

/*----------------------------------------------------------------------------*/

/* S2 TRIGGER CONDITIONS */

/*----------------------------------------------------------------------------*/

[define|neutral] TRIGGER_POSITIVE := {

keywords: ["agent-creation", "foundry", "workflow"],

context: "user needs agent-creation capability"

} [ground:given] [conf:1.0] [state:confirmed]

/*----------------------------------------------------------------------------*/

/* S3 CORE CONTENT */

/*----------------------------------------------------------------------------*/

<!-- SKILL SOP IMPROVEMENT v1.0 -->

Skill Execution Criteria

When to Use This Skill

• Creating new specialist agents with domain-specific expertise
• Refining existing agent system prompts for better performance
• Designing multi-agent coordination systems
• Implementing role-based agent hierarchies
• Building production-ready agents with embedded domain knowledge

When NOT to Use This Skill

• For simple one-off tasks that don't need agent specialization
• When existing agents already cover the required domain
• For casual conversational interactions without systematic requirements
• When the task is better suited for a slash command or micro-skill

Success Criteria

• [assert|neutral] primary_outcome: "Production-ready agent with optimized system prompt, clear role definition, and validated performance" [ground:acceptance-criteria] [conf:0.90] [state:provisional]
• [assert|neutral] quality_threshold: 0.9 [ground:acceptance-criteria] [conf:0.90] [state:provisional]
• [assert|neutral] verification_method: "Agent successfully completes domain-specific tasks with consistent high-quality output, passes validation tests, and integrates with Claude Agent SDK" [ground:acceptance-criteria] [conf:0.90] [state:provisional]

Edge Cases

• case: "Vague agent requirements"

handling: "Use Phase 1 (Initial Analysis) to research domain, identify patterns, and clarify scope before proceeding"

• case: "Overlapping agent capabilities"

handling: "Conduct agent registry search, identify gaps vs duplicates, propose consolidation or specialization"

• case: "Agent needs multiple conflicting personas"

handling: "Decompose into multiple focused agents with clear coordination pattern"

Skill Guardrails

NEVER:

• "Create agents without deep domain research (skipping Phase 1 undermines quality)"
• "Use generic prompts without evidence-based techniques (CoT, few-shot, role-based)"
• "Skip validation testing (Phase 3) before considering agent production-ready"
• "Create agents that duplicate existing registry agents without justification"

ALWAYS:

• "Complete all 4 phases: Analysis -> Prompt Engineering -> Testing -> Integration"
• "Apply evidence-based prompting: Chain-of-Thought for reasoning, few-shot for patterns, clear role definition"
• "Validate with diverse test cases and measure against quality criteria"
• "Document agent capabilities, limitations, and integration points"

Evidence-Based Execution

self_consistency: "After agent creation, test with same task multiple times to verify consistent outputs and reasoning quality"

program_of_thought: "Decompose agent creation into: 1) Domain analysis, 2) Capability mapping, 3) Prompt architecture, 4) Test design, 5) Validation, 6) Integration"

plan_and_solve: "Plan: Research domain + identify capabilities -> Execute: Build prompts + test cases -> Verify: Multi-run consistency + edge case handling"

<!-- END SKILL SOP IMPROVEMENT -->

Agent Creation - Systematic Agent Design

Kanitsal Cerceve (Evidential Frame Activation)

Kaynak dogrulama modu etkin.

Evidence-based agent creation following best practices for prompt engineering and agent specialization.

When to Use This Skill

Use when creating new specialist agents for specific domains, refining existing agent capabilities, designing multi-agent coordination systems, or implementing role-based agent hierarchies.

4-Phase Agent Creation SOP

Phase 1: Specification

• Define agent purpose and domain
• Identify core capabilities needed
• Determine input/output formats
• Specify quality criteria

Tools: Use resources/scripts/generate_agent.sh for automated generation

Phase 2: Prompt Engineering

• Apply evidence-based prompting principles
• Use Chain-of-Thought for reasoning tasks
• Implement few-shot learning with examples (2-5 examples)
• Define role and persona clearly

Reference: See references/prompting-principles.md for detailed techniques

Phase 3: Testing & Vali

/*----------------------------------------------------------------------------*/

/* S4 SUCCESS CRITERIA */

/*----------------------------------------------------------------------------*/

[define|neutral] SUCCESS_CRITERIA := {

primary: "Skill execution completes successfully",

quality: "Output meets quality thresholds",

verification: "Results validated against requirements"

} [ground:given] [conf:1.0] [state:confirmed]

/*----------------------------------------------------------------------------*/

/* S5 MCP INTEGRATION */

/*----------------------------------------------------------------------------*/

[define|neutral] MCP_INTEGRATION := {

memory_mcp: "Store execution results and patterns",

tools: ["mcp__memory-mcp__memory_store", "mcp__memory-mcp__vector_search"]

} [ground:witnessed:mcp-config] [conf:0.95] [state:confirmed]

/*----------------------------------------------------------------------------*/

/* S6 MEMORY NAMESPACE */

/*----------------------------------------------------------------------------*/

[define|neutral] MEMORY_NAMESPACE := {

pattern: "skills/foundry/agent-creation/{project}/{timestamp}",

store: ["executions", "decisions", "patterns"],

retrieve: ["similar_tasks", "proven_patterns"]

} [ground:system-policy] [conf:1.0] [state:confirmed]

[define|neutral] MEMORY_TAGGING := {

WHO: "agent-creation-{session_id}",

WHEN: "ISO8601_timestamp",

PROJECT: "{project_name}",

WHY: "skill-execution"

} [ground:system-policy] [conf:1.0] [state:confirmed]

/*----------------------------------------------------------------------------*/

/* S7 SKILL COMPLETION VERIFICATION */

/*----------------------------------------------------------------------------*/

[direct|emphatic] COMPLETION_CHECKLIST := {

agent_spawning: "Spawn agents via Task()",

registry_validation: "Use registry agents only",

todowrite_called: "Track progress with TodoWrite",

work_delegation: "Delegate to specialized agents"

} [ground:system-policy] [conf:1.0] [state:confirmed]

/*----------------------------------------------------------------------------*/

/* S8 ABSOLUTE RULES */

/*----------------------------------------------------------------------------*/

[direct|emphatic] RULE_NO_UNICODE := forall(output): NOT(unicode_outside_ascii) [ground:windows-compatibility] [conf:1.0] [state:confirmed]

[direct|emphatic] RULE_EVIDENCE := forall(claim): has(ground) AND has(confidence) [ground:verix-spec] [conf:1.0] [state:confirmed]

[direct|emphatic] RULE_REGISTRY := forall(agent): agent IN AGENT_REGISTRY [ground:system-policy] [conf:1.0] [state:confirmed]

/*----------------------------------------------------------------------------*/

/* PROMISE */

/*----------------------------------------------------------------------------*/

[commit|confident] <promise>AGENT_CREATION_VERILINGUA_VERIX_COMPLIANT</promise> [ground:self-validation] [conf:0.99] [state:confirmed]