CtrlK
BlogDocsLog inGet started
Tessl Logo

bounded-work-item

Execute one scoped implementation or investigation item and return evidence without changing workflow authority.

54

Quality

60%

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 ./docs/plantree/plans/agentic-loop-workflow/drafts/agentroles.coder/skills/bounded-work-item/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 body is an exceptionally lean, well-structured instruction set with explicit sequencing, boundaries, and termination conditions. Its main weakness is actionability: verification and evidence-return steps state intent without naming concrete methods or formats, leaving the executor to improvise the most consequential parts.

Suggestions

Make step 4 concrete: name the focused verification to run (e.g., specific test command pattern or acceptance-ref check) and what evidence output should contain.

State the exact rework loop condition, e.g., what bounded rework may touch and how to re-submit after fixes.

Specify the format of the returned result (e.g., a structured list of changed paths, verification output, blockers, terminal status) so 'done' reports are consistent.

DimensionReasoningScore

Conciseness

The body is lean and directive with zero padding — every line is an instruction or a boundary, and it fully assumes Claude's competence (e.g., 'Detect repository metadata once'). This matches anchor 5 (lean, efficient, every token earns its place); nothing could be cut without losing guidance.

5 / 5

Actionability

Steps are specific directives and include one exact command ('ask --chain --artifact-reply'), but key execution details are missing: 'Run focused verification when possible' names no verification method, and the required evidence format for the returned 'verification evidence' is unspecified. This is anchor 3 (some concrete guidance but incomplete); anchor 4 would need the verification and submission mechanics spelled out.

3 / 5

Workflow Clarity

The six-step sequence is clear with an explicit rework loop and stop conditions ('After Reviewer pass, perform no more file/tool mutation and immediately return...'). It is not anchor 5 because validation is conditional ('when possible') rather than an explicit checkpoint with an error-recovery path; it is above anchor 3 because sequencing, rework, and termination are all explicit.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no external references needed, and its content is organized into clear 'Workflow' and 'Boundaries' sections. Per the simple-skill guidance, well-organized sections alone warrant anchor 5; there are no bundle files to evaluate and no buried or nested references.

5 / 5

Total

17

/

20

Passed

Description

42%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 states a clear, compact 'what' but lacks any explicit trigger guidance and leans on orchestration jargon ('workflow authority') that no user would naturally say. It is serviceable but generic enough to risk both weak triggering and overlap with general implementation skills.

Suggestions

Add a 'Use when...' clause naming the concrete trigger (e.g., 'Use when the controller supplies a single work packet with declared refs and allowed paths').

Replace abstract phrasing like 'workflow authority' with natural keywords a requester would say, such as 'work item', 'task packet', 'scoped change', or 'evidence report'.

Expand the capability list slightly (e.g., inspect, edit within allowed paths, run focused verification, submit evidence to the Reviewer) to sharpen both specificity and distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain ('scoped implementation or investigation item') and two concrete actions ('Execute', 'return evidence'), but coverage is thin and 'without changing workflow authority' is abstract. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than anchor 4, which expects a fuller list of specific actions.

3 / 5

Completeness

The 'what' is explicit (execute one scoped item, return evidence), but there is no 'Use when...' clause or equivalent trigger guidance, capping completeness at 3 per the judging guidelines. It is not a 2 because the 'what' half is clearly stated.

3 / 5

Trigger Term Quality

The only candidate keywords are orchestration jargon ('workflow authority', 'evidence', 'scoped item') rather than natural phrases a user would say when needing this skill. It sits at anchor 2 (one or two generic keywords, missing the natural phrases users say); anchor 3 would require relevant keywords like 'task', 'work item', or 'ticket' that a requester might actually use.

2 / 5

Distinctiveness Conflict Risk

'Without changing workflow authority' gives it a recognizable niche, but 'implementation or investigation item' is broad enough to overlap with general coding and research skills. Anchor 3 (somewhat specific but could still overlap with similar skills) fits; anchor 4 would require a tighter, less contestable scope.

3 / 5

Total

11

/

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
SeemSeam/claude_codex_bridge
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.