CtrlK
BlogDocsLog inGet started
Tessl Logo

adapt

Adapt project-local flowai primitives (skills, agents, AGENTS.md artifacts, hooks) to project specifics. Standalone adaptation — independent of update.

56

Quality

65%

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/skills/adapt/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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 skill body is a well-structured, highly actionable workflow with strong validation checkpoints and feedback loops appropriate to its destructive/batch file-rewriting scope. Its main weaknesses are an inlined long path enumeration in step 5 that could move to a reference and references that are not clearly signaled as navigation links.

Suggestions

Extract the step 5 install-mode template-location enumeration into a reference file (e.g. references/template-locations.md) and link to it, keeping step 5 to the resolution rule.

Add explicit "See [AGENTS.template.md](assets/AGENTS.template.md)" navigation signals for the bundled asset rather than only inline path mentions.

Tighten repeated lines such as "Use only project-local paths under the current working tree" (steps 3 and 4) into a single shared constraint in the Rules section.

DimensionReasoningScore

Conciseness

The body is dense with actionable specifics (e.g. "git show HEAD:<path>", "git diff HEAD -- <skill-path>", "git checkout HEAD -- <skill-path>") and the <context> block covers flowai-specific behavior Claude would not know, with no padding about concepts Claude already knows. Matches the efficient-with-minor-trim anchor; not a 5 because the long install-mode path enumeration in step 5 and repeated "Use only project-local paths" lines could be tightened, not a 3 because it is not noticeably padded.

4 / 5

Actionability

Provides concrete executable commands throughout ("git diff --no-index -- <template> <artifact>", "git show HEAD:<path>/SKILL.md", subagent delegation with explicit inputs) plus specific pre-filter logic. Matches mostly-executable with minor gaps; not a 5 because commands are woven into prose rather than copy-paste blocks and subagent interfaces/todo-write usage are assumed ("e.g., todo write"), not a 3 because guidance is concrete and complete rather than pseudocode.

4 / 5

Workflow Clarity

The seven-step sequence has explicit validation checkpoints and feedback loops for destructive/batch file rewrites: "verify the diff actually replaces stale commands ... rerun the adapter or fix", frontmatter "byte-for-byte identical" checks, per-resource confirmation gates, "Revert rejected adaptations: git checkout HEAD", plus a dedicated <verification> checklist. Matches the clear-sequence-with-explicit-validation-and-feedback-loops anchor; not a 4 because validation is explicit rather than minor-gaps.

5 / 5

Progressive Disclosure

The body is well-sectioned (Overview, Rules, Instructions, Verification) and references one bundle file (assets/AGENTS.template.md) as a one-level runtime input, but step 5 inlines a ~20-line install-mode path enumeration that belongs in a separate reference, and references are not formatted as clearly signaled navigation links (no "See X for details"). Matches the some-structure-but-could-be-better-organized anchor; not a 4 because the inlined bulk and unclear reference signaling are real organization gaps, not a 2 because section structure is present and content is not an unstructured wall.

3 / 5

Total

16

/

20

Passed

Description

53%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 clearly states what the skill does and names concrete flowai resource types, but lacks an explicit "Use when..." trigger clause and leans on technical framing over natural user phrasing. It is distinct within the flowai ecosystem yet could be more trigger-friendly and action-specific.

Suggestions

Add an explicit trigger clause, e.g. "Use after first project-local flowai install, a stack change, or when project skills/agents/hooks still contain generic examples like `deno test` that conflict with the project stack."

Replace the generic verb "adapt ... to project specifics" with several concrete actions (e.g. "replace generic commands/examples with project-specific ones from AGENTS.md, preserve frontmatter, stage changes without committing").

Add natural synonyms and file/extensions a user might say (e.g. "flowai skills, agents, hooks, AGENTS.md") to broaden trigger coverage.

DimensionReasoningScore

Specificity

Quotes "Adapt project-local flowai primitives (skills, agents, AGENTS.md artifacts, hooks) to project specifics" enumerate four concrete resource categories, but the single action verb "adapt ... to project specifics" is generic rather than listing multiple concrete actions, matching the anchor that names a domain with 1-2 concrete actions but is not comprehensive. It is not a 4 because no several specific actions (e.g. rewrite commands, replace examples) are enumerated, and not a 2 because the four named resource types are concrete, not minimal.

3 / 5

Completeness

"Adapt project-local flowai primitives ... to project specifics" gives a clear what, but the only when guidance is the weakly implied "Standalone adaptation — independent of update" with no explicit "Use when..." clause, so completeness is capped at 3 per the rubric guideline. It is not a 4 because no explicit trigger clause exists, and not a 2 because the what is clearly stated rather than vague.

3 / 5

Trigger Term Quality

Phrases like "skills", "agents", "hooks" are natural terms a user might say, but "flowai primitives", "AGENTS.md artifacts", and "Standalone adaptation — independent of update" are technical framing with missing common synonyms or file extensions. Matches the anchor with some relevant keywords but missing common variations; not a 4 because natural phrasing coverage is incomplete, not a 2 because more than one or two generic keywords are present.

3 / 5

Distinctiveness Conflict Risk

The flowai-specific scope ("flowai primitives", "independent of update") carves a clear niche distinct from sibling commands, with only minor overlap risk from the broad verb "adapt" and the four resource types. Matches the mostly-distinct anchor; not a 5 because the generic action verb leaves slight overlap risk, not a 3 because the flowai framing is specific rather than broadly overlapping.

4 / 5

Total

13

/

20

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository
korchasa/flowai-plugins
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.