القائمة
Use when creating, editing, or reviewing HOTL skills, agents, command prompts, or other behavior-shaping instruction files.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when executing an existing HOTL workflow file — reads steps, loops until success criteria met, auto-approves low-risk gates, pauses at high-risk gates.
Resume an interrupted workflow run with verify-first strategy — loads sidecar state, verifies the last step, and continues execution.
Use when executing an implementation plan linearly with explicit human checkpoints between batches of tasks.
Use after execution is complete or intentionally stopped — decide whether to merge back, publish a PR branch, keep the execution checkout, or discard it, and record that disposition in HOTL state.
Use when executing an accepted HOTL workflow through the best available host or fallback driver.
Delegated step runner over the HOTL execution state machine — delegates eligible steps to fresh subagents while the controller keeps governance, verification, and stop conditions.
| name | skill-authoring |
| description | Use when creating, editing, or reviewing HOTL skills, agents, command prompts, or other behavior-shaping instruction files. |
HOTL skills are behavior-shaping code. Treat changes to skill text, agent prompts, command routers, and adapter instructions with the same care as production logic: define the failure mode, make the desired behavior explicit, verify the change, and update every index or mirror that exposes it.
Use this before changing:
skills/*/SKILL.mdagents/*.mdcommands/*.mdcline/rules/*.mdDo not use it for ordinary product docs, generated reports, or local project README edits unless they change how agents should behave.
State the behavior change
Choose the right abstraction
Write trigger-only frontmatter
name: kebab-case, no command-name collision.description: says when to activate, not the workflow steps.Keep behavior text testable
Update routing and mirrors
skills/using-hotl/SKILL.md.docs/skills.md, README tables, and Codex docs for user-visible skill changes.Verify behavior
bats test/smoke.bats before claiming the skill change is ready.The frontmatter description is discovery text, not a miniature skill. If it contains a workflow summary, an agent may act on that summary without reading the full body.
Bad:
description: Use when executing plans - dispatches workers, reviews every task, then finalizes
Good:
description: Use when executing implementation workflows that can delegate contained steps to fresh subagents.
using-hotl.