measuring-ai-proficiency: Skill for Claude Code

Intent Framed Agent

Install

npx skills add pskoett/pskoett-ai-skills

npx skills add pskoett/pskoett-ai-skills/skills/intent-framed-agent

Purpose

This skill turns implicit intent into an explicit, trackable artifact at the moment execution starts. It creates a lightweight intent contract, watches for scope drift while work is in progress, and closes each intent with a short resolution record.

Scope (Important)

Use this skill for coding tasks only. It is designed for implementation work that changes executable code.

Do not use it for general-agent activities such as:

• broad research
• planning-only conversations
• documentation-only work
• operational/admin tasks with no coding implementation

For trivial edits (for example, simple renames or typo fixes), skip the full intent frame.

Trigger

Activate at the planning-to-execution transition for non-trivial coding work.

Common cues:

• User says: "go ahead", "implement this", "let's start building"
• Agent is about to move from discussion into code changes

Workflow

Phase 1: Intent Capture

At execution start, emit:

## Intent Frame #N

**Outcome:** [One sentence. What does done look like?]
**Approach:** [How we will implement it. Key decisions.]
**Constraints:** [Out-of-scope boundaries.]
**Success criteria:** [How we verify completion.]
**Estimated complexity:** [Small / Medium / Large]

Rules:

• Keep each field to 1-2 sentences.
• Ask for confirmation before coding:
  • Does this capture what we are doing? Anything to adjust before I start?
• Do not proceed until the user confirms or adjusts.

Phase 2: Intent Monitor

During execution, monitor for drift at natural boundaries:

• before touching a new area/file
• before starting a new logical work unit
• when current action feels tangential

Drift examples:

• work outside stated scope
• approach changes with no explicit pivot
• new features/refactors outside constraints
• solving a different problem than the stated outcome