auto-trigger

Auto-Trigger Hooks

This skill defines trigger intent between skills. When a skill completes its workflow, a host runtime or agent may read this metadata, record a pending follow-up, and execute the next skill only when that action is supported and safe for the current session.

Hook Definitions

PRD Creation Chain

prd_complete:
  triggers:
    - skill: self-improving-agent
      mode: background
      condition: PRD file exists and is complete
    - skill: session-logger
      mode: auto
      context: "PRD created for {feature_name}"

prd_implemented:
  triggers:
    - skill: session-logger
      mode: auto
      context: "Implemented PRD: {feature_name}"

Implementation Chain

implementation_complete:
  triggers:
    - skill: code-reviewer
      mode: ask_first
      message: "Implementation complete. Run code review?"
    - skill: create-pr
      mode: ask_first
      condition: user_requested_submission

Session Management

session_start:
  auto_triggers:
    - skill: session-logger
      action: create_session_file

session_end:
  auto_triggers:
    - skill: session-logger
      action: update_session_file

Hook Format in Skills

To add auto-trigger capability to a skill, add to its front matter:

---
name: my-skill
description: Skill description
allowed-tools: Read, Write, Edit
hooks:
  before_start:
    - trigger: session-logger
      mode: auto
      context: "Start {skill_name}"
  after_complete:
    - trigger: self-improving-agent
      mode: background
    - trigger: session-logger
      mode: auto
  on_error:
    - trigger: self-improving-agent
      mode: background
---

Implementation Guide

When a skill completes its workflow:

1. Check hooks in its own front matter (before_start, after_complete, on_error, on_progress)
2. For each hook:
   • If mode: auto, record or run a low-risk follow-up only when the host runtime supports it
   • If mode: background, record a non-blocking follow-up; do not mutate durable files silently
   • If mode: ask_first, ask user before triggering
   • If condition: exists, check it first
3. Pass context to the triggered skill