klausborges/workflow-skills

simplify-work

Simplify an already-bounded code or documentation area without changing intended behavior.

First seen Jul 15, 2026

Installation

$ npx skills add klausborges/workflow-skills --skill simplify-work

Summary

  • Simplify an already-bounded code or documentation area without changing intended behavior.
  • Use for deletion, direct-flow refactors, wrapper or branch reduction, clearer data models, reduced mutable state, or concrete simplification findings; use improve-architecture when the opportunity or design is still unclear.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from klausborges/workflow-skills · top by installs.

npx skills add klausborges/workflow-skills

Browse all from klausborges/workflow-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1
License LICENSE
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,871 B
  • docs SUMMARY.md 336 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 110 installs

SKILL.md

Simplify Work

Make the selected area easier to understand, change, and verify while preserving intended behavior.

Use [engineering-discipline.md](references/engineering-discipline.md). Accept a direct scope, handoff, review finding, or Plan as input.

Boundaries

  • Read repo instructions and relevant current docs; inspect the workspace so preexisting changes are not mistaken for task work.
  • Confirm the bounded surface, intended behavior, callers, constraints, and proof before editing.
  • Do not scan the whole repo, create a Plan or handoff, run an interview, or produce HTML by default.
  • Do not use line count as the goal. Prefer fewer concepts, branches, layers, mutable states, and duplicated rules when that reduces reader load.
  • Preserve unrelated dirty work and preexisting drafts or prototypes. Clean only task-created artifacts whose disposition is clear.
  • If the change requires new product behavior, changing a declared compatibility contract, or unresolved architecture placement, stop for owner judgment or route discovery to improve-architecture.

Simplify

  1. Establish a focused behavior check. Add characterization coverage only when existing evidence cannot protect consequential behavior.
  2. Trace the relevant caller, data, component, or control flow and find the accidental structure carrying the cost.
  3. Prefer deletion, direct data flow, canonical ownership, and types or data models that remove invalid states and spread-out branching.
  4. Keep each change small enough to reason about and verify. Avoid unrelated cleanup and speculative abstraction.
  5. Run focused checks as the work proceeds, then the relevant regression or acceptance gate. Read the results.

For Plan-backed work, select the requested or next unchecked Phase, follow its checkpoints, and update Tasks or acceptance criteria only after evidence supports them. Apply only that Phase's Doc Delta and referenced-draft work; after fresh review and fixes, update the Plan/docs before marking it complete. Leave Plan or Roadmap cleanup to final review. Without a Plan, do not invent Plan mechanics.

Close the scope

Self-check behavior preservation and whether the result materially lowers reader load. Send the entire scope, not only the latest patch, to an independent fresh-context reviewer through review-work; verify accepted claims against primary evidence, fix authorized blocking findings, and rerun affected checks. Report the simplification, behavior evidence, and residual risk concisely.