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.

66

Quality

83%

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

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, clearly sequenced protocol skill with copy-paste-ready structured blocks and explicit checkpoints for every phase and edge case. Its weakest point is token efficiency: install duplication and the long cross-skill coordination sections (Entire CLI, context-surfing interop) pad the file and could be tightened or moved to a references file.

Suggestions

Collapse the three install variants (two `gh skill install` commands plus the npx fallback) into one primary command plus one fallback to cut redundant install content.

Move the 'Relationship with context-surfing' precedence/cadence detail and the 'How intent frames become learning signals' subsection into a references/ file, keeping a one-line pointer in SKILL.md.

Tighten the Entire CLI section: the `entire status` caveat about transcript coverage can be reduced to a single sentence without losing the operational rule.

DimensionReasoningScore

Conciseness

The core protocol is tight — templates, rules, and drift examples earn their tokens — but several sections could be tightened: three overlapping install commands, extended Entire CLI caveats, and the ~80-line context-surfing interoperability section re-explains coordination that could be halved or split out. Mostly efficient with unnecessary padding in specific places, not the minor trimmable instances of a 4.

3 / 5

Actionability

For an instruction-only skill, the guidance is fully executable: exact copy-paste markdown templates for Intent Frame/Check/Resolution, precise emit conditions ('before touching a new area/file', 'when current action feels tangential'), concrete drift examples, multi-intent ordering rules, and a runnable detection command (`entire status 2>/dev/null`). Common cases (trivial tasks, missing session-context, resume, mid-task pivots) are all explicitly handled.

5 / 5

Workflow Clarity

The phases (Intent Capture → Session Context → Monitor → Resolution) are clearly sequenced with explicit checkpoints: drift checks at natural boundaries, a hard rule to not proceed while a material decision is unresolved, and feedback loops (detect → ask → return to scope or update frame, plus multi-intent resolve-before-open ordering). No destructive or batch operations, so no validation cap applies.

5 / 5

Progressive Disclosure

A single well-sectioned file with clear headers (Install, Purpose, Scope, Trigger, Workflow, Multi-Intent, Guardrails, Interoperability) that is easy to navigate, and no bundle files exist to reference. The Entire CLI integration and context-surfing relationship sections are long enough that they would fit a separate references file, leaving minor organization gaps rather than the ideal split of a 5.

4 / 5

Total

17

/

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 strong description: third-person voice, explicit 'Use when...' clause with concrete trigger terms, and a clearly stated purpose. Its main gap is specificity — only two of the skill's actions are named, so the full capability surface (intent frames, checks, resolutions) is underrepresented in the summary.

DimensionReasoningScore

Specificity

The description names the domain ('coding-agent work sessions') and two concrete actions ('explicit intent capture and drift monitoring'), but omits the resolution record and the rest of the workflow, so coverage is not comprehensive. It falls below 4, which requires several specific actions listed.

3 / 5

Completeness

It explicitly 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 concrete trigger phrases. This matches the anchor-5 example structure closely.

5 / 5

Trigger Term Quality

Good natural keyword coverage — 'coding tasks, refactors, feature builds, bug fixes, multi-step execution' — plus the transition cue 'planning/Q&A to implementation'. A few natural user phrasings (e.g. 'write the code', 'make this change', 'ship this feature') are missing, keeping it below 5.

4 / 5

Distinctiveness Conflict Risk

'Explicit intent capture and drift monitoring' at the planning-to-execution transition is a distinct niche with dedicated triggers, but it can overlap with general planning or coding-workflow skills when a refactor or feature build starts. Minor overlap risk with closely related skills, not the minimal-conflict clarity of a 5.

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

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.