CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

autonomous-workflow

The phase machinery (0–7) behind the `aw` dispatcher: task intake through a tested draft PR in an isolated worktree, gated by the plan.md brief and the run-checks.mjs sentinel, with companions that never block. Not the entry point — natural-language requests for autonomous work go to the `aw` skill; invoke /autonomous-workflow only to run the phases directly.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/workflow/autonomous-workflow/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is an exemplary orchestrator index: every phase has an explicit gate, validation is deterministic (sealed checks, sentinel lines, iteration caps), and error-recovery paths are spelled out. Its few weaknesses are repetition of the mandatory-phase rule, an extended tier-detection rationale, and a reference graph that the provided bundle only partially backs with real files.

DimensionReasoningScore

Conciseness

The body is a dense, telegraphic index ("never `which gh`, never `gh auth status`") that explains nothing Claude already knows, but "Phase 0 and Phase 2 are mandatory" is stated three times and the Q2/Q4 exegesis under "Two readings this exists to rule out" runs long, leaving minor instances that could be trimmed — anchor 4 rather than 5.

4 / 5

Actionability

Concrete, executable guidance dominates: `bash scripts/sync-symlinks.sh --aw`, `gw add <branch>`, an exact MODE SELECTION output block, and a complete worked Lite brief template. Core phase procedures are deliberately deferred to `rules/*.md`, so in-body guidance is mostly rather than fully copy-paste complete, fitting anchor 4.

4 / 5

Workflow Clarity

The phases 0–7 table gives every phase an explicit gate ("Suite green, then `run-checks.mjs` prints `CHECKS M/M PASS`"), mandatory phases are flagged, termination is sentinel-based and deterministic, stuck-loop caps escalate via `Skill("confidence", "analysis")`, and feedback loops are explicit ("A failed `ui:` criterion … re-enters Phase 3 under the same turn cap"; "Watch CI, `ci-auto-fix` if needed") — a clear match for the anchor-5 validation-and-recovery pattern.

5 / 5

Progressive Disclosure

The body declares itself an index ("procedures live in `rules/*.md` and load on demand") with one-level-deep, condition-signaled references ("read when a prerequisite is missing", "each read when it applies"). Against the actual bundle, however, most referenced paths (rules/, templates/, aw/, CLAUDE.md, README.md) are absent and 8 of the 9 files in references/ are not reachable from the body, so navigation is good but not fully verifiable — anchor 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Description

71%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is concrete and unusually self-aware about routing, explicitly carving out its niche from the sibling `aw` skill, which gives it excellent distinctiveness and solid completeness. Its weakness is trigger-term coverage: it is written for someone who already knows the system's vocabulary (dispatcher, sentinel, companions) rather than for a user naturally describing a need, and it enumerates machinery more than actions.

Suggestions

Add one or two natural-language trigger phrases users would actually say (e.g. "when the user asks to run the workflow phases directly, bypassing the `aw` dispatcher's intake") so the skill is discoverable by description rather than only by name.

Recast one clause as enumerated actions (e.g. "creates an isolated worktree, writes a sealed acceptance-criteria brief, runs the check sentinel, opens a draft PR") instead of the architectural "phase machinery behind the `aw` dispatcher" framing.

Define or drop the most opaque jargon ("sentinel", "companions that never block") so the description reads without prior knowledge of the `aw` system.

DimensionReasoningScore

Specificity

Concrete mechanisms are named end-to-end — "task intake through a tested draft PR in an isolated worktree", "gated by the plan.md brief and the run-checks.mjs sentinel" — but the description frames them as architecture ("the phase machinery behind the `aw` dispatcher") rather than enumerating several distinct actions, so it sits between the 3 and 5 anchors at 4.

4 / 5

Completeness

Both what and when are explicit — "invoke /autonomous-workflow only to run the phases directly" is equivalent explicit trigger guidance, so the missing-'Use when' cap does not apply — but the when clause is a routing boundary against the sibling `aw` skill rather than a fuller set of concrete situational trigger phrases, fitting anchor 4 rather than 5.

4 / 5

Trigger Term Quality

Some relevant natural terms appear ("autonomous work", "draft PR", "worktree", "task"), but the description leans on internal jargon ("dispatcher", "sentinel", "companions that never block") and omits common user phrasings like autonomously implementing a feature or running phases directly, matching the "some relevant keywords but missing common variations" anchor.

3 / 5

Distinctiveness Conflict Risk

"Not the entry point — natural-language requests for autonomous work go to the `aw` skill" actively disambiguates this skill from its sibling dispatcher, giving it a clear niche with distinct triggers and minimal conflict risk, which matches the anchor-5 example exactly.

5 / 5

Total

16

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 33 missing, 1 deeper-than-1-level, 3 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

12

/

16

Passed

Repository

mthines/agent-skills

Path

skills/workflow/autonomous-workflow/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.