# Tw Refine

> Refines an existing skill in place with minimal diffs, using evidence from usage and session mining to improve triggers, workflow, metadata, and resources.

- Skill: `sdiamante13/tw-refine` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sdiamante13/tw-refine`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sdiamante13/tw-refine/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Tags: Minimal Diff, Session Mining, Skill Maintenance, Skill Refinement
- Author: SDiamante13 (https://skillmd.com/u/sdiamante13)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/sdiamante13/tw-refine

---


# Refine

## Overview

Refine a target skill by turning evidence into minimal, validated in-place updates.

## Inputs

- Target skill name or path
- Improvement signals (user feedback, session mining notes, errors, missing steps)
- Constraints (minimal diff, required tooling)

## Example Prompts

- "Refine the docx skill to tighten triggers."
- "Add a small script to the pdf skill."
- "Use session-mining notes to refine the gh skill's workflow."

## Workflow (Double Diamond)

### Discover

- Read the target skill's `SKILL.md` and any `scripts/`, `references/`, or `assets/`.
- Collect evidence from usage: confusion points, missing steps, bad triggers, or stale metadata.
- If no example prompts are provided, synthesize 2-3 realistic prompts that should trigger the skill.

### Define

- Write a one-line problem statement and 2-3 success criteria.
- Choose the smallest change set that addresses the evidence.
- Record explicit constraints (minimal diffs, required tooling).

### Develop

- List candidate updates: frontmatter description, workflow steps, new resources.
- Prefer minimal-incision improvements; only add resources when they are repeatedly reused or required for determinism.

### Deliver

- Implement the chosen changes directly in the target skill.
- Keep SKILL.md frontmatter compliant for the target skill (name/description only unless the skill explicitly needs allowed-tools).
- If adding scripts, run a representative sample to confirm behavior.

## Output Checklist

- Updated `SKILL.md` with accurate triggers and clear workflow
- New or modified resources (scripts/references/assets) if justified