Quick Skill
Purpose
Atomic task execution without SDLC ceremony. Fills the gap between "raw Claude" and /fix//implementation:
- No opusplan model switch
- No task list creation
- No TDD by default
- No PR creation
- Issue GitHub optional
Use when a change takes minutes, not hours.
When to Use vs Other Skills
/quick |
/fix |
/implementation |
|
|---|---|---|---|
| Ceremony | None | Minimal | Full (TDD, opusplan) |
| Size | Tiny (minutes) | Small-medium | Medium-large |
| Type | Anything | Bug / tech debt | Feature / refactor |
| Issue required | No | No | No |
| PR created | No | Optional (--pr) |
Yes |
| Tests required | No | Regression only | Full TDD |
Usage
/quick fix the failing auth test
/quick --discuss add rate limiting to the API # disambiguate before executing
/quick --full refactor the user service # run /pre-commit after execution
/quick --issue 42 update error message # link to GitHub issue in commit
Workflow
Bare mode (default)
- Snapshot — Run
git statusandgit branch --show-currentto establish context - Execute — Implement the minimal change
- Trivial edit (1-2 files): work on current branch
- Slightly larger:
git checkout -b <type>/brief-description
- Smoke tests — After executing, always output a short checklist (3–5 items) the user can run manually before committing. Infer from modified files:
- REST endpoint →
curlcommands (happy path + one error case) - Frontend → numbered browser steps
- CLI → shell commands
- Library/module →
python -c "..."one-liner
- REST endpoint →
- Gate — Run
/security-verify scanbefore committing (non-negotiable perrules/security-gate.md) - Commit — Atomic commit with conventional-commits message:
- With issue:
fix: <description>+Fixes #42in commit body - Without issue:
fix: <description>orfeat: <description>
- With issue:
- Review suggestion — After committing, always suggest:
"Run
/review changesto get a companion second opinion before moving on." - Track — Append entry to
.claude/memory/local/quick-tasks.md
--discuss mode
Before executing:
- Ask 2-3 targeted disambiguation questions (scope, approach, edge cases)
- Save decisions to
.claude/memory/local/CONTEXT.md - Proceed with bare mode
--full mode
After executing:
- Delegate to
/pre-commit(quality + tests + security + changelog) - Use this when the change touches logic where regression is a real risk
Constraints
- Stay on current model — no
/model opussuggestion - No
TaskCreatecalls - No TDD unless
--fullflag - No
gh pr create— use/fixor/implementationif a PR is needed - Security scan always mandatory before commit
Tracking: quick-tasks.md
After each execution, append to .claude/memory/local/quick-tasks.md:
### YYYY-MM-DD HH:MM — <task description>
- Branch: <branch-name> or "current branch (no new branch)"
- Commit: <sha> "<message>"
- Mode: bare | discuss | full
- Issue: #N or —
File is session-scoped and gitignored (memory/local/ is never committed).
Tips
- If the change grows beyond ~30 minutes of work, switch to
/fixor/implementation --discussis especially useful when the task is ambiguous or touches multiple areas--fullis for logic changes (not just config/text) where test coverage matters