CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

frame-intent

Frame intent for an agentic workflow with a desired outcome, explicit assumptions, and leading indicators so specification is grounded in purpose. Use before discovery or specification, when work is described as the thing being built, or when a product, AI use case, internal capability, or operating change lacks evidence for steering. Produce a usable intent brief while coaching the human on outcome thinking and discovery through the decisions at hand. Applies at any scale of work and supplies intent to the receiving workflow's discovery, specification, and planning steps.

Quality

81%

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

71%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 well-structured instruction skill: a clearly sequenced six-step framing workflow with per-field output specs and correct offloading of maintenance/evaluation scenarios to a real, well-labeled reference file. The main cost is density — long hedged sentences, restated outcomes, and a credits section consume tokens without adding operational value.

Suggestions

Tighten the multi-clause sentences in Intake, Frame the intent, and Boundaries by splitting each into its decision plus one guard, cutting roughly a third of the tokens without losing guidance.

Trim the References/Inspiration/Credits section to the credit line and links, or move it into the reference file with the acceptance scenarios.

Add a short worked example of a completed intent brief (even five lines) in the Output section to make the deliverable fully concrete.

DimensionReasoningScore

Conciseness

There is little padding or explanation of concepts Claude already knows, but the prose is dense and could be tightened: the Outcome section restates the description, many sentences stack three or four hedges ('Do not impose discovery when proportionate evidence already supports delivery'), and the References/Inspiration/Credits section is non-operational. Mostly efficient but noticeably compressible, matching the 3 anchor rather than the 4 anchor's 'minor instances that could be trimmed'.

3 / 5

Actionability

For an instruction-only skill the guidance is concrete and executable: each numbered step specifies exactly what to state ('owner, why it matters now, baseline, target, and time horizon'; 'measure and population, baseline, proposed target or threshold, source, owner, review timing, and action different results would prompt'), and the Output section enumerates the brief's contents field by field. Not a 5 because no worked example of a finished intent brief is provided, leaving the concrete artifact shape inferred rather than shown.

4 / 5

Workflow Clarity

The process is clearly sequenced — read intake first, frame the intent in six ordered steps, then output and handoff — with decision points at each branch ('With enough context, synthesize directly'; 'With weak evidence ... recommend the smallest useful experiment') and feedback loops such as updating the brief as answers arrive and separating confirmed/inferred/proposed/unknown. Below 5 because there is no explicit final self-check of the brief against the outcome indicators before handoff; checkpoints are mostly embedded in prose rather than called out.

4 / 5

Progressive Disclosure

Structure is appropriate: all operational guidance lives in the main file, and the one bundle file (references/tests.md) is a clearly signaled, one-level-deep reference with its purpose stated ('For maintenance or evaluation, read references/tests.md for trigger cases and behavioral acceptance scenarios'); the file exists and matches that description. Nothing that belongs in a separate file is inlined, fitting the 5 anchor rather than the 4 anchor, which reserves minor organization gaps.

5 / 5

Total

16

/

20

Passed

Description

83%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: third-person voice, explicit multi-condition 'Use when' guidance, and a concrete picture of what the skill produces and hands off. Trigger keywords are natural for spec-driven product workflows, with only a few synonyms (goals, hypotheses, success metrics) absent.

Suggestions

Add one or two common user-side synonyms (e.g., 'goal', 'success metrics') to the trigger clause so users who don't use 'intent' vocabulary still match.

Slightly compress the third and fourth sentences, which restate scope and handoff; the same trigger coverage can be kept in fewer tokens.

DimensionReasoningScore

Specificity

Concrete actions are named — 'Frame intent for an agentic workflow with a desired outcome, explicit assumptions, and leading indicators', 'Produce a usable intent brief', 'coaching the human on outcome thinking', 'supplies intent to the receiving workflow's discovery, specification, and planning steps' — with only minor abstractness. Not a 5 because the actions are process-level rather than the fully comprehensive, concrete operation list of the top anchor.

4 / 5

Completeness

Both halves are explicit: the 'what' is 'Frame intent ... with a desired outcome, explicit assumptions, and leading indicators ... Produce a usable intent brief', and the 'when' is a concrete 'Use before discovery or specification, when work is described as the thing being built, or when a product, AI use case, internal capability, or operating change lacks evidence for steering'. Not the 4 anchor because the 'when' clause is specific and multi-conditioned rather than needing more explicitness.

5 / 5

Trigger Term Quality

Good natural-keyword coverage: 'intent', 'outcome', 'assumptions', 'leading indicators', 'discovery', 'specification', 'product, AI use case, internal capability, or operating change', plus the natural trigger phrase 'when work is described as the thing being built'. A few common synonyms users might say are missing (e.g., 'goals', 'objectives', 'hypotheses', 'success metrics'), keeping it below the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche — intent framing upstream of discovery/specification — is clear with distinct triggers ('before discovery or specification', 'lacks evidence for steering'), and the body explicitly routes adjacent asks (wording polish, readiness, portfolio) to sibling skills. Minor overlap remains with adjacent goal-setting/OKR or 'define success metrics' skills, so not the minimal-conflict 5 anchor.

4 / 5

Total

17

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

yyeret/ai-impact

Path

skills/frame-intent/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.