CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

intent-framed-agent

Frames coding-agent work sessions with explicit intent capture and drift monitoring. Use when a session transitions from planning/Q&A to implementation for coding tasks, refactors, feature builds, bug fixes, or other multi-step execution where scope drift is a risk.

60

Quality

76%

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 ./plugin/skills/intent-framed-agent/SKILL.md

The canonical home for this skill is intent-framed-agent in pskoett/pskoett-ai-skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 core three-phase workflow is concrete and well-sequenced, with excellent copy-paste templates and a real drift feedback loop. The skill is let down by verbosity in the interoperability and Entire CLI sections and by keeping material that belongs in a separate reference file inline in SKILL.md.

Suggestions

Move the 'Entire CLI Integration' and 'How intent frames become learning signals' sections into a references/entire-integration.md file and keep a one-line pointer plus the detection command in SKILL.md.

Compress the 'Relationship with context-surfing' and 'Cadence separation' prose into a short bullet list (failure modes monitored, precedence rule, cadence rule), cutting the multi-sentence re-explanations.

Add one concrete example of a refined intent frame after Phase 1a to make the 'refine the approach' guidance executable rather than abstract.

DimensionReasoningScore

Conciseness

The workflow phases are efficient and template-driven, but the interoperability and Entire CLI sections contain noticeable padding and repetition — e.g., 'They are complementary, not redundant. An agent can be perfectly on-scope while its context quality degrades. Conversely, scope drift can happen with perfect context quality.' restates the same distinction multiple ways. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' better than anchor 4.

3 / 5

Actionability

Copy-paste-ready markdown templates for Intent Frame, Intent Check, and Intent Resolution, plus concrete commands (gh skill install, npx skills add, entire status) and specific drift triggers. Minor gaps: some passages remain abstract, such as 'Use useful cited findings to refine the approach', with no example of a refined frame.

4 / 5

Workflow Clarity

A clear Phase 1 → 1a → 2 → 3 sequence with explicit checkpoints and a genuine feedback loop (drift detected → ask whether pivot is intentional → return to scope or update frame), plus 'Do not proceed while a material decision remains unresolved' as a hard gate. Minor gaps in multi-skill coordination details (e.g., exact interplay ordering when several companion skills fire) keep it below anchor 5.

4 / 5

Progressive Disclosure

No bundle files exist and the ~260-line body has clear section headers, but content that clearly belongs in separate reference files is inlined — notably the ~60-line 'Entire CLI Integration' section with learning-signal details and the extended context-surfing relationship prose. This matches 'some structure but could be better organized; content that should be separate is inline'.

3 / 5

Total

14

/

20

Passed

Description

78%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-formed description with an explicit 'Use when...' trigger clause, natural task-type keywords, and a clearly distinct niche. Its main weakness is specificity: it names only two actions and omits the concrete artifacts (intent frame, drift check, resolution record) the skill actually emits.

Suggestions

Enumerate the concrete artifacts the skill produces (e.g., 'emits an intent frame, runs drift checks, and closes each intent with a resolution record') to raise specificity beyond two generic actions.

Include one or two natural trigger phrases users say at execution start (e.g., 'go ahead', 'implement this') in the when-clause to improve trigger term coverage.

Mention that trivial edits are out of scope to sharpen distinctiveness against general planning-assistant skills.

DimensionReasoningScore

Specificity

The description names the domain ('coding-agent work sessions') and exactly two concrete actions ('explicit intent capture and drift monitoring'), matching the anchor for 1-2 concrete actions but not comprehensive coverage. It does not list the concrete artifacts produced (intent frame, drift check, resolution record), which would lift it to anchor 4.

3 / 5

Completeness

It clearly answers both what ('Frames coding-agent work sessions with explicit intent capture and drift monitoring') and when ('Use when a session transitions from planning/Q&A to implementation for coding tasks, refactors, feature builds, bug fixes...') with a concrete, explicit trigger clause.

5 / 5

Trigger Term Quality

Good keyword coverage with natural user terms — 'coding tasks', 'refactors', 'feature builds', 'bug fixes', 'multi-step execution' — that users would plausibly say. A few natural trigger phrases (e.g., 'go ahead', 'implement this', session-start cues) are only present in the body, not the description, keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

The intent-contract/scope-drift niche at the planning-to-execution transition is distinct from most skills. Minor overlap risk exists with planning or context-management skills, which keeps it below the 'minimal conflict risk' anchor.

4 / 5

Total

16

/

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

pskoett/pskoett-ai-skills

Path

plugin/skills/intent-framed-agent/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.