CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-workflow

Sets up how you and your team build and work with AI agents, and produces an Agent Workflow Charter (agent lanes, plan-mode loop, autonomy ladder with promotion criteria, rules file, review policy, security rules, rollout plan). Use when you ask 'how should we work with Claude Code / Codex / Cursor', 'how many agents should I run', 'should the agent be autonomous', 'plan mode', 'CLAUDE.md', 'AI-native team', 'roll out AI to my team', or 'my agent keeps screwing up'. Draws on 110 Lenny's Podcast guests incl. Claire Vo, Boris Cherny and Aishwarya Naresh Reganti.

73

Quality

92%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

A dense, expert-level skill body that is highly actionable and well-sequenced, with explicit done-when checkpoints, promotion criteria, a fill-in charter deliverable, and a grading rubric. Its weaknesses are modest: an inline 'Receipts' section duplicating references/quotes.md, and a long body whose charter template and grading rubric could move to reference files for better progressive disclosure.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — terse tables, numbered plays with specific thresholds ('80% of tasks in plan mode', 'heartbeat check every 30-60 minutes', 'drafts used mostly as-is for ~4 weeks') and no padding explaining what agents are. However, the 'Receipts' section inlines six full quotes while 'Go deeper' points to references/quotes.md for 'verified quotes with timestamps' — duplicated content that could be trimmed — so it sits at anchor 4 ('Efficient; minor instances of over-explanation that could be trimmed') rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

For an instruction-only skill the guidance is exceptionally concrete: a diagnose-then-route table, seven plays with numbered steps and per-play 'Done when' criteria, a five-rung autonomy ladder with default promotion thresholds, a copy-paste-ready fill-in charter template, and a 1/3/5 grading rubric with a defined output format. This matches anchor 5 ('specific examples cover the common cases') and clearly exceeds anchor 4's 'minor gaps'.

5 / 5

Workflow Clarity

The process is clearly sequenced (Step 1 Diagnose with an explicit skip rule when docs are attached → Step 2 Pick the play → Step 3 Run it → Deliverable → Grade → Red flags) with validation checkpoints throughout: 'Done when' criteria per play, 'Loop until it can' verification in the plan loop, and promotion criteria with review dates on the ladder. This matches anchor 5 ('clear sequence with explicit validation steps; feedback loops; checklists'), not anchor 4 which allows minor validation gaps.

5 / 5

Progressive Disclosure

Both bundle files exist and are clearly signaled one level deep in 'Go deeper' ('references/frameworks.md - every framework in this skill, how to run it'; 'references/quotes.md - verified quotes with timestamps'), plus well-scoped handoffs to related skills. But the ~190-line body inlines substantial material that could live in references — the full charter template, the 7-criterion grading rubric, and the six duplicated receipt quotes — matching anchor 4 ('most content is appropriately placed; minor organization gaps') rather than anchor 5's appropriately-split ideal.

4 / 5

Total

18

/

20

Passed

Description

91%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.

A strong description that explicitly states what the skill produces (a seven-part Agent Workflow Charter) and when to use it, with an unusually rich set of natural trigger phrases including named tools and failure symptoms. The only notable flaw is second-person voice ('you and your team', 'you ask'), which costs it specificity points under the rubric's voice guideline.

DimensionReasoningScore

Specificity

The description lists multiple concrete deliverables — 'produces an Agent Workflow Charter (agent lanes, plan-mode loop, autonomy ladder with promotion criteria, rules file, review policy, security rules, rollout plan)' — giving comprehensive coverage that would anchor at 5, but it is written in second person ('Sets up how you and your team build...', 'Use when you ask...'), which the guidelines penalize by reducing specificity by 1. It is clearly above anchor 3 (only 1-2 actions) since it enumerates seven concrete charter components plus the setup activity itself.

4 / 5

Completeness

It explicitly answers both parts: 'what' ('Sets up how you and your team build and work with AI agents, and produces an Agent Workflow Charter...') and 'when' ('Use when you ask...') with concrete trigger phrases. This matches anchor 5 exactly ('Clearly and explicitly answers both what AND when with concrete trigger phrases'); anchor 4 would require a weaker or less explicit 'when' clause, which is not the case here.

5 / 5

Trigger Term Quality

It quotes a broad set of natural phrases users would actually say: 'how should we work with Claude Code / Codex / Cursor', 'how many agents should I run', 'should the agent be autonomous', 'plan mode', 'CLAUDE.md', 'AI-native team', 'roll out AI to my team', 'my agent keeps screwing up'. This includes tool names, symptom phrasing ('keeps screwing up'), and rollout vocabulary, matching the comprehensive-synonym coverage of anchor 5 rather than the 'a few natural terms missing' of anchor 4.

5 / 5

Distinctiveness Conflict Risk

Triggers like 'plan mode', 'CLAUDE.md', and 'how should we work with Claude Code' carve a clear agent-workflow niche, but 'CLAUDE.md' and general Claude Code setup questions could also fire a CLAUDE.md-authoring or onboarding skill — minor overlap risk with closely related skills, matching anchor 4 ('Mostly distinct; minor overlap risk') rather than anchor 5's minimal conflict risk.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

menkesu/awesome-pm-skills

Path

skills/agent-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.