CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

adapt

Use when the user asks to tailor the installed flowai skills, agents, hooks or AGENTS.md artifacts to this project's specifics. Not for first-time setup, template reconciliation, or edits to the project's own code.

64

Quality

80%

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

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.

A highly actionable, well-sequenced orchestration skill with strong validation checkpoints, feedback loops, and safety rails (per-file confirmation, reverts, read-only boundaries). Its weaknesses are verbosity in rationale paragraphs and an exhaustive inline path enumeration that could be compressed.

Suggestions

Compress the rationale paragraphs in steps 3 and 7 into single rule sentences (e.g. 'Collect every adapter result in foreground mode before presenting anything' / 'Write the summary before the first confirmation request'), moving the why to one shared note.

Replace the 3-tier, 12+ path template-location enumeration with a short ordered lookup rule (skill-local plugin asset, then {ide}/assets/, then user-level) and fold the per-IDE path variants into a one-line pattern like ".{ide}/skills/adapt/assets/AGENTS.template.md".

DimensionReasoningScore

Conciseness

The body is mostly directive and free of basic-concept padding, but several passages over-explain rationale at length — e.g. "**Waiting means collecting, not listening.** ... Sitting idle until a notification arrives is not waiting: the first notification to land is one adapter's..." and "A run legitimately ends at the approval gate — the user may answer tomorrow, or not at all — and a summary placed behind that gate is a summary the run never produces." — plus the 12-path, 3-tier template location enumeration. These could each be tightened to a rule sentence, so it sits at anchor 3 rather than 4's minor trimming.

3 / 5

Actionability

Fully executable instruction guidance: exact commands ("git diff HEAD -- <skill-path>", "git checkout HEAD -- <agent-path>", "git show HEAD:<path>/SKILL.md", "git diff --no-index -- <template> <artifact>"), named subagents with their exact inputs, concrete default mapping ("AGENTS.template.md -> AGENTS.md"), explicit parallel-dispatch and revert steps, and a verification checklist. As an instruction-only skill this is copy-paste-ready guidance, matching anchor 5.

5 / 5

Workflow Clarity

The 7-step sequence is explicit with validation checkpoints and feedback loops throughout: verify diffs actually replace stale commands before presenting ("rerun the adapter for that skill or fix the proposal"), byte-for-byte frontmatter verification with restore-on-change, per-resource confirmation gates, revert-on-rejection, and a final checklist. This covers the batch-operation feedback-loop requirement, matching anchor 5.

5 / 5

Progressive Disclosure

The workflow is appropriately self-contained in one well-sectioned SKILL.md, and the sole bundle asset (assets/AGENTS.template.md) is verified to exist and is properly kept out of the body, referenced by resolved path in step 5. The minor gap is the exhaustive inline three-tier path enumeration (~19 candidate paths) that would be cleaner as a compact lookup or a short references note, placing it at anchor 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Description

73%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 well-scoped description with an explicit Use-when trigger, third-person voice, useful negative boundaries, and a distinct flowai-specific niche. Its main weakness is that the action verb stays abstract — 'tailor to project's specifics' — without naming concrete actions like replacing generic commands or verifying artifacts against templates.

Suggestions

Add 1-2 concrete actions to the description, e.g. 'Replaces generic stack commands (deno test/lint) with project-specific ones from AGENTS.md and verifies AGENTS.md artifacts against their framework template.'

Make the 'when' more occasion-specific, e.g. 'Use after a first project-local flowai install or after the project's tech stack changes, or when the user asks to adapt/customize flowai resources.'

DimensionReasoningScore

Specificity

The description enumerates the concrete object types it operates on ("flowai skills, agents, hooks or AGENTS.md artifacts") but the action itself remains generic ("tailor... to this project's specifics") without listing what tailoring concretely does. It names the domain well but is not comprehensive in actions, matching anchor 3 rather than 4, which expects several specific actions listed.

3 / 5

Completeness

Both parts are present: what ("tailor the installed flowai skills, agents, hooks or AGENTS.md artifacts to this project's specifics") and an explicit "Use when the user asks to tailor..." trigger, plus negative boundaries ("Not for first-time setup, template reconciliation, or edits to the project's own code"). The 'when' could be more occasion-specific (after install, after a stack change), keeping it at anchor 4 rather than 5.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "tailor", "skills", "agents", "hooks", "AGENTS.md artifacts", "project's specifics", reinforced by the skill name "adapt". A few natural synonyms users might say ("customize", "update to my stack") are missing, so it falls at anchor 4 rather than 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: it is scoped to "flowai" framework primitives and explicitly excludes adjacent tasks ("Not for first-time setup, template reconciliation, or edits to the project's own code"), minimizing conflict with setup/update/code-editing skills. This matches anchor 5's clear niche with minimal conflict risk.

5 / 5

Total

16

/

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.

Validation — 14 / 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

Path

plugins/flowai/skills/adapt/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.