Skip to content
cccskills
FreePublished on GitHub

tw-refine

Refine an existing skill in place with minimal diffs. Trigger when asked to improve a skill's trigger description/frontmatter, workflow text, metadata, scripts/references/assets; also for requests to iterate, refactor, rename, or fix a skill using usage/session-mining evidence (for example from /tw-seq).

The English summary is being prepared. Showing the original description.

SDiamante13/dotfiles
See how to install

Files included (1)

  • SKILL.md1.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

agent-browser

Free

Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.

The English summary is being prepared. Showing the original description.

SDiamante13/dotfiles10Updated Oct 2, 2026

catchup

Free

Rebuilds session context after a clear by reading git history, plans, and beads state. Triggers on 'catch up'.

The English summary is being prepared. Showing the original description.

SDiamante13/dotfiles10Updated Oct 2, 2026

changelog

Free

Generate a bullet-point summary of branch changes for a PR description. Triggers on "changelog", "pr summary", "summarize branch", or "/changelog".

The English summary is being prepared. Showing the original description.

SDiamante13/dotfiles10Updated Oct 2, 2026

commit

Free

Commit the current changes with quality checks, status review, staged diff inspection, appropriate tests, and a clear commit message. Use when the user says "commit", "c", asks to make a commit, or wants changes saved in git.

The English summary is being prepared. Showing the original description.

SDiamante13/dotfiles10Updated Oct 2, 2026

declutter

Free

Refactor code to remove dead code, useless comments, unused variables, and unused imports. Use when asked to declutter a class, clean up noisy code, remove cruft, or run `/refactor:declutter`.

The English summary is being prepared. Showing the original description.

SDiamante13/dotfiles10Updated Oct 2, 2026

dry

Free

Refactor duplicated code by extracting helpers, shared abstractions, or clearer reusable structure. Use when asked to apply DRY, remove duplication, consolidate repeated logic, or run `/refactor:dry`.

The English summary is being prepared. Showing the original description.

SDiamante13/dotfiles10Updated Oct 2, 2026

See all skills by SDiamante13

Report a problem with this skill