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.

64

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

70%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 intent workflow is exemplary — templated artifacts, explicit checkpoints, and a genuine drift feedback loop. The main weaknesses are peripheral sections (Entire CLI and sibling-skill interoperability prose) that pad token cost and belong in reference files, and a few abstract directives among otherwise concrete guidance.

Suggestions

Move the "Entire CLI Integration" section (including "How intent frames become learning signals") and the "Interoperability with Other Skills" detail into a separate references/ file, keeping only a one-line pointer in SKILL.md — this would lift both conciseness and progressive_disclosure.

Trim redundant guardrail bullets ("Do not over-trigger on trivial tasks" / "Do not interrupt on every small step") and the context-surfing precedence/cadence paragraphs down to their operative rules.

Replace subjective drift cues like "when current action feels tangential" with operational signals (e.g., the current tool target is outside the files/modules named in the frame's constraints) to close the actionability gap.

DimensionReasoningScore

Conciseness

The core phases are tight, but ~260 lines include padded interop prose ("Relationship with context-surfing", precedence/cadence rules), an explanation of how Entire transcripts consume the frames ("You do not need to do anything special for this"), and redundant guardrails ("Do not over-trigger on trivial tasks" vs "Do not interrupt on every small step"). Not a 4: several sections could be trimmed or dropped without losing actionable guidance; not a 2: most sections are dense rules and templates, not concept explanations Claude already knows.

3 / 5

Actionability

Copy-paste-ready markdown templates for Intent Frame, Intent Check, and Intent Resolution, a concrete detection command (`entire status 2>/dev/null`), enumerated drift examples, and numbered multi-intent rules make this mostly executable as an instruction-only skill. Not a 5: a few directives remain abstract ("when current action feels tangential", Phase 1a's "It owns the retrieval budget and relevance checks") with no operational definition.

4 / 5

Workflow Clarity

Three explicit phases (Capture → 1a Session Context → Monitor → Resolution) with concrete drift-check checkpoints ("before touching a new area/file", "before starting a new logical work unit"), a feedback loop (drift detected → ask pivot-or-creep → resume or return to scope), and a gating rule ("Do not proceed while a material decision remains unresolved"). Not a 4: validation checkpoints and error-recovery paths are explicit throughout, not implicit.

5 / 5

Progressive Disclosure

The body is a single ~260-line file with no bundle files (no references/, scripts/, or assets/ exist) and well-organized section headers. Content that would arguably live in separate reference files (Entire CLI integration, interoperability with five sibling skills, the context-surfing relationship) is fully inlined. Not a 4: the peripheral integration material buries the core workflow rather than being split out; not a 2: section structure is clear and navigation within the file is easy.

3 / 5

Total

15

/

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, concise, with explicit "Use when" trigger guidance covering natural task terms. It clearly communicates both capability and activation timing with minor keyword-coverage gaps.

DimensionReasoningScore

Specificity

"Frames coding-agent work sessions with explicit intent capture and drift monitoring" lists several concrete actions (framing, intent capture, drift monitoring) in third-person voice. Not a 5: the coverage misses resolution records and multi-intent handling that the skill actually performs, so gaps are more than minor; not a 3: more than 1-2 generic actions are named.

4 / 5

Completeness

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 situations. Both halves are present, explicit, and concrete — matches the 5 anchor exactly.

5 / 5

Trigger Term Quality

"coding tasks, refactors, feature builds, bug fixes, or other multi-step execution where scope drift is a risk" provides natural phrases users would say at the planning-to-execution transition. Not a 5: common variations like "scope creep", "implementation phase", or session-cue phrases ("go ahead") are absent; not a 3: keyword coverage goes well beyond a single domain keyword.

4 / 5

Distinctiveness Conflict Risk

The planning-to-execution transition plus "where scope drift is a risk" carves a mostly-distinct niche from generic coding or planning skills. Not a 5: the trigger surface ("coding tasks, refactors, feature builds, bug fixes") is broad and could overlap with sibling skills like plan-interview or session-context at the same transition moment; not a 3: the drift-monitoring framing is a clear differentiator.

4 / 5

Total

17

/

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

.agents/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.