CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

engineer-subagent

Guide for creating effective Subagents (custom agent definitions). Use when users want to create a new subagent, set up task-specific agents, configure code reviewers, debuggers, or domain-specific assistants. Works across IDEs (Cursor, OpenCode).

60

Quality

75%

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 ./plugins/flowai-devtools/skills/engineer-subagent/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 highly actionable with an excellent phased workflow, executable commands, and complete templates. It is let down by token inefficiency (duplicated path tables, concept explanation, and ~130 lines of inlined examples) and by keeping all of that detail in SKILL.md instead of moving examples into a references file.

Suggestions

Delete one of the two path tables — "Control Primitives Map by IDE" and "Subagent-Specific Paths" carry identical information; keep a single table and cut the "About Subagents" concept intro, which Claude already knows.

Move the four full example agent definitions (code-reviewer, debugger, data-scientist, docs-specialist, ~130 lines) into references/examples.md and keep one exemplar plus a one-line pointer per type in SKILL.md.

The OpenCode/Cursor additional-field tables could collapse into a single compact field reference in a separate file, leaving SKILL.md as the workflow overview.

DimensionReasoningScore

Conciseness

The ~400-line body contains several padded or redundant sections: the "Control Primitives Map by IDE" table and the "Subagent-Specific Paths" table present the identical path information twice; "About Subagents" explains the subagent concept Claude already knows; and four complete example agent definitions (~130 lines) plus a "Comparison with Skills" section are inlined wholesale. Not score 3 because the redundancy is substantial and structural, not occasional over-explanation; not score 1 because the content stays on-task with no filler prose about libraries or basics.

2 / 5

Actionability

Guidance is copy-paste ready throughout: exact frontmatter YAML blocks per IDE, concrete `mkdir -p .cursor/agents && touch ...` commands, good/bad description examples, full agent templates, and a verification checklist. Not score 4 because the examples cover the common cases (code-reviewer, debugger, data-scientist, docs) and the commands are directly executable with no gaps.

5 / 5

Workflow Clarity

The five-phase workflow (Discovery → Design → Implementation → Verification → Iterate) is clearly sequenced, with an explicit verification checklist ("Test the subagent: 'Use the my-agent subagent to [task]'") and a built-in feedback loop ("Use on real tasks → notice struggles → update → test again"). Not score 4 because validation checkpoints and the error-recovery loop are both explicit, not implicit.

5 / 5

Progressive Disclosure

Section headers are clear and consistent, but there are no references/scripts/assets files at all, and large content that belongs in separate files — the four full example agent definitions and the duplicated path tables — is inlined in SKILL.md. Not score 4 because well over a hundred lines of example content should be split into a one-level-deep references file; not score 2 because the document is well-sectioned and navigable, not a wall of text with buried references.

3 / 5

Total

15

/

20

Passed

Description

70%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 has an explicit and well-scoped "Use when" clause with natural trigger phrases and a clearly named domain, giving it good discoverability. Its main weakness is a generic "what" ("Guide for creating effective Subagents") that does not enumerate the skill's concrete capabilities, and an IDE list that omits Claude Code.

Suggestions

Replace the generic "Guide for creating effective Subagents" with concrete capabilities, e.g. "Drafts subagent YAML frontmatter (name, description, model, mode) and system-prompt bodies, picks the correct storage path per IDE, and validates the result against a checklist."

Add the missing trigger keyword "Claude Code" to the IDE list ("Works across IDEs (Claude Code, Cursor, OpenCode)") and consider adding path-based triggers such as ".claude/agents" that users naturally mention.

State the deliverable explicitly ("creates a single .md agent file in the IDE-appropriate agents directory") so the 'what' answers both what is produced and how.

DimensionReasoningScore

Specificity

"Guide for creating effective Subagents (custom agent definitions)" names the domain and one core action (creating subagents), but the remaining phrases ("set up task-specific agents, configure code reviewers, debuggers, or domain-specific assistants") read as trigger scenarios rather than additional concrete capabilities. Not score 4 because it does not list several specific actions (contrast the anchor's "Extracts text, fills forms, converts pages to images"); not score 2 because the domain is precisely named and the action is concrete.

3 / 5

Completeness

The "when" is explicit and multi-scenario ("Use when users want to create a new subagent, set up task-specific agents, configure code reviewers, debuggers, or domain-specific assistants"), and a "what" is present ("Guide for creating effective Subagents"). Not score 5 because the "what" is generic — "Guide for creating effective" does not state concrete capabilities the way the anchor-5 example does ("Extract text and tables from PDF files, fill forms, merge documents"). Not score 3 because both what and when are present, with the when explicitly stated.

4 / 5

Trigger Term Quality

Natural phrases users would say are present: "create a new subagent", "set up task-specific agents", "configure code reviewers, debuggers", plus IDE names "Cursor, OpenCode". Not score 5 because common synonyms are missing — notably "Claude Code" is omitted from the IDE list even though the body covers it, and there are no path/extension hooks like ".claude/agents". Not score 3 because keyword coverage across the request space (create/set up/configure, multiple agent types) is good.

4 / 5

Distinctiveness Conflict Risk

The subagent-creation niche is distinct and trigger terms ("create a new subagent", named IDEs) are unlikely to fire unrelated skills. Not score 5 because "set up task-specific agents" and "configure code reviewers, debuggers, or domain-specific assistants" have minor overlap risk with general agent-configuration or prompt-engineering skills. Not score 3 because the core trigger language is specific to subagents, not merely "somewhat specific".

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

korchasa/flowai-plugins

Path

plugins/flowai-devtools/skills/engineer-subagent/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.