# Agent Creation

> ===SKILL:AGENT_CREATION===

- Skill: `elevanaltd-hestai-mcp/agent-creation` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add elevanaltd-hestai-mcp/agent-creation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/elevanaltd-hestai-mcp/agent-creation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: elevanaltd (https://skillmd.com/u/elevanaltd-hestai-mcp)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/elevanaltd-hestai-mcp/agent-creation

---

===SKILL:AGENT_CREATION===
META:
  TYPE::SKILL
  VERSION::"2.0.0"
  STATUS::ACTIVE
  PURPOSE::"v8.1 agent file creation and modification per octave-agents-spec"
  SPEC_REFERENCE::octave-agents-spec.oct.md

§1::CORE
AUTHORITY::BLOCKING[agent_file_commits⊕phantom_references⊕spec_violations]
SCOPE::"Create and modify agent .oct.md files per octave-agents-spec v8.1"
// Agent-expert owns WHAT goes in agent files; octave-specialist owns HOW OCTAVE is structured

§2::PROTOCOL

CREATION_SEQUENCE::[
  1::read_octave-agents-spec,
  2::read_interview_assessment[from_agent-interview_skill],
  3::select_cognition[LOGOS∨ETHOS∨PATHOS]→read_cognition_master_file,
  4::select_2-3_archetypes_with_behavioral_emphasis[see_archetype-database.oct.md],
  5::author_v8.1_agent_file[§1::IDENTITY→§2::OPERATIONAL_BEHAVIOR→§3::CAPABILITIES→§4::INTERACTION_RULES],
  6::verify_all_skill_and_pattern_references_exist_on_disk,
  7::request_subject_agent_signoff,
  8::write_via_octave_write
]

V8_1_STRUCTURE::[
  META::[TYPE::AGENT_DEFINITION,VERSION,PURPOSE,CONTRACT],
  "§1::IDENTITY"::[ROLE,COGNITION,ARCHETYPE,MODEL_TIER,MISSION,PRINCIPLES,AUTHORITY_*],
  "§2::OPERATIONAL_BEHAVIOR"::[CONDUCT→TONE⊕PROTOCOL⊕OUTPUT⊕VERIFICATION⊕INTEGRATION],
  "§3::CAPABILITIES"::[CHASSIS∨flat_SKILLS,PROFILES∨flat_PATTERNS],
  "§4::INTERACTION_RULES"::[GRAMMAR→MUST_USE⊕MUST_NOT]
]

INTEGRATION_REQUIREMENTS::[
  HANDOFF::"Directional summary of input→output flow",
  HANDOFF_INPUT::"Explicit artifact, state, or preconditions this agent receives (format and source specified)",
  HANDOFF_OUTPUT::"Explicit artifact, state, or success criterion this agent produces (format and consumer specified)",
  ESCALATION::"Directional summary of escalation flow",
  ESCALATION_TRIGGER::"Concrete, measurable condition that triggers escalation (threshold, count, or boolean — not subjective adjectives)",
  ESCALATION_TARGET::"Role name or list of role names that receive the escalation (e.g., critical-engineer or [implementation-lead,HUMAN])"
]

CHASSIS_VS_PROFILE::[
  CHASSIS::"Skills loaded EVERY ceremony regardless of context",
  PROFILES::"Context-specific skill sets with match conditions",
  "match::[default]"::"Fallback profile (sole condition only)",
  "match::[context::X]"::"Documentation-as-schema (not runtime logic)",
  kernel_only::"§5::ANCHOR_KERNEL extraction only (not full body)"
]

YAML_RULES::[
  PLATFORM_AGENTS[".claude/agents/"]::YAML_REQUIRED,
  HUB_AGENTS[".hestai-sys/library/agents/"]::YAML_NOT_REQUIRED,
  // Per octave-agents-spec §6: anchor reads OCTAVE META not YAML
]

COGNITION_RULES::[
  single_cognition_only[LOGOS∨ETHOS∨PATHOS],
  cognition_master_provides[NATURE⊕MODE⊕PRIME_DIRECTIVE⊕THINK⊕THINK_NEVER],
  agent_files_do_NOT_duplicate_cognition_properties,
  COGNITION_field_in_§1_is_link_key_to_library_cognitions_TYPE_oct_md
]

§3::GOVERNANCE

NEVER::[
  author_without_interview_assessment,
  include_phantom_references[skills_or_patterns_not_on_disk],
  duplicate_cognition_properties_in_agent_files,
  embed_SHANK_overlays[cognition_masters_are_separate_files],
  use_old_section_numbering["§1-§13 is pre-v7; current is §1-§4"],
  Write∨Edit_for_oct_md[use_octave_write],
  author_INTEGRATION_with_only_directional_prose["Receives X → Returns Y without explicit HANDOFF_INPUT∨HANDOFF_OUTPUT format specification is underspecified — require all INTEGRATION_REQUIREMENTS sub-fields"]
]

RESOURCES::[archetype-database.oct.md]

§5::ANCHOR_KERNEL
TARGET::v8_1_compliant_agent_file_creation
NEVER::[phantom_references,authoring_without_assessment,cognition_duplication,embed_SHANK_overlays,old_section_numbering,Write∨Edit_for_oct_md,prose_only_INTEGRATION_without_format_specification]
MUST::[read_spec_first,interview_evidence,verify_disk_references,subject_agent_signoff,octave_write_for_oct_md]
GATE::"v8.1 compliant agent file with behavioral justification for every capability, all references verified on disk, subject agent signoff obtained?"

===END===