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

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

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 well-executed instruction skill: fully actionable templates, an explicitly sequenced workflow with drift checkpoints and feedback loops, and clean section structure. The weakest area is token efficiency — the interoperability and Entire CLI sections explain at length what could be stated in a few rules or moved to a reference file.

Suggestions

Trim the 'Relationship with context-surfing' section to the two-line distinction plus the precedence and cadence rules; cut the explanatory sentences ('They are complementary, not redundant. An agent can be perfectly on-scope while its context quality degrades. Conversely...') that restate the distinction already made.

Move the 'How intent frames become learning signals' and detailed Entire CLI detection prose into a references/ file (e.g. references/entire-integration.md), keeping only the activation-time behavior ('run `entire status`; on failure continue silently') in SKILL.md.

Collapse the Install section to one primary command plus a single fallback line instead of three alternative install blocks.

DimensionReasoningScore

Conciseness

The body is mostly tight, rule-based instruction, but several sections over-explain: the ~80 lines of interoperability prose ('They are complementary, not redundant. An agent can be perfectly on-scope while its context quality degrades. Conversely...'), the precedence/cadence discussion, and the redundant triple install commands pad the token budget. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4, where over-explanation would be only minor.

3 / 5

Actionability

Fully concrete instruction-only guidance: copy-paste-ready markdown block templates for all three artifacts (Intent Frame, Intent Check, Intent Resolution) with exact headers and fields, exact commands (`entire status 2>/dev/null`, `gh skill install pskoett/pskoett-skills`), explicit drift-detection triggers, and numbered multi-intent rules. This matches the top anchor — specific examples cover the common cases with nothing left as vague direction.

5 / 5

Workflow Clarity

The three phases are clearly sequenced (capture → 1a context → monitor → resolution) with explicit checkpoints: drift checks at named boundaries (before touching a new file, new logical work unit, tangential action) and a genuine feedback loop (check → ask if pivot is deliberate → update frame or return to original scope). The operations are not destructive/batch, so no validation cap applies; this fits the anchor with explicit validation steps and error-recovery loops.

5 / 5

Progressive Disclosure

No bundle files exist; the skill is one ~254-line SKILL.md with clear, well-ordered sections (Purpose, Scope, Trigger, Workflow phases, Guardrails, Interop). Most content is appropriately placed for a process skill, but the Entire CLI integration and context-surfing relationship sections (~80 lines of detail not needed at activation time) are inline where a reference file would fit better — a minor organization gap matching the 4 anchor rather than the 5's clean overview-plus-references split.

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 that clearly and explicitly states both what the skill does and when to use it, with good natural trigger terms and a distinct niche. The main weakness is capability coverage: only two of the skill's three mechanisms (capture, monitoring) appear — the resolution/close-out step is missing.

Suggestions

Add the resolution phase to the capability list, e.g. '...and closes each intent with a short resolution record', to raise specificity from naming 2 actions to a comprehensive list.

Include one or two more natural trigger phrases users say at the execution transition (e.g. 'implement this', 'go ahead') to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ("coding-agent work sessions") and two concrete actions — "explicit intent capture" and "drift monitoring" — matching the anchor for 1-2 concrete actions that are not comprehensive. It is not a 4 because the resolution/close-out phase and the concrete artifacts (frame, check, resolution blocks) are absent, leaving coverage gaps.

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, or other multi-step execution where scope drift is a risk") with concrete trigger contexts. Both clauses are present, explicit, and concrete, matching the top anchor; a 4 would require the 'when' to be less specific, which it is not.

5 / 5

Trigger Term Quality

Natural user-facing terms are well covered: "coding tasks", "refactors", "feature builds", "bug fixes", "multi-step execution" — phrases a user would plausibly say. It is not a 5 because common trigger synonyms such as "implement", "let's build", or "scope creep" are absent.

4 / 5

Distinctiveness Conflict Risk

The niche — intent capture and drift monitoring at the planning-to-execution transition — is distinct with clear triggers, but it names a workflow stage that overlaps with general planning/execution skills (plan-interview, session-context) referenced in the body. It is mostly distinct with minor overlap risk against closely related skills, fitting the 4 anchor rather than the 5's minimal-conflict profile.

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

agent-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.