Setting the file. One moment.
Example Workflow Process Skill · Skill Writer · getsentry/skills · Skills Docs
Back to the top of the page 23.10
Example Hook Backed Skill
Goal: create a skill for repeatable operational workflows (for example PR prep, CI triage, branching, settings audit).
This case collected process truth from all authoritative locations:
Official tool docs and syntax references.
Repository workflow conventions and policy docs.
Existing local skills with adjacent process logic.
CI logs, failure patterns, and known operational pitfalls.
Positive and negative historical examples from prior runs.
Collection stopped only after failure and recovery paths were well represented.
Required dimensions tracked during synthesis:
Preconditions and required context.
Ordered execution flow.
Safety/permission boundaries.
Expected outputs and acceptance checks.
Failure handling and retry behavior.
Escalation and handoff behavior.
The resulting skill references included:
Happy-path execution transcript.
Guarded variant with stricter safety constraints.
Failure-recovery transcript for a critical broken step.
Output template for deterministic reporting.
Changelog rules for iterative improvement from examples.
Source class: repo policy docs.
Decision: add explicit precondition checks before running side-effecting steps.
Why: prevented invalid execution in partially configured environments.
Source class: CI failure logs.
Decision: add a mandatory failure triage branch with retry vs escalate criteria.
Why: reduced dead-end loops during workflow execution.
Source class: historical positive/negative examples.
Decision: standardize output format for easier review and iteration.
Why: made regressions and improvements comparable across runs.
Happy-path transcript snippet:
Preconditions pass -> execute steps 1..N -> emit structured summary with status per step.
Failure-recovery transcript snippet:
Step fails -> classify transient/permanent -> retry once or escalate with captured evidence.
Deterministic report template:
Sections: Preconditions, Actions Taken, Validation Results, Failures/Recoveries, Next Actions.
The workflow was executable without rediscovering steps.
Non-happy paths were first-class, not afterthoughts.
Outputs were structured for consistent review and iteration.
references/example-workflow-process-skill.md