workflow skills personal agent workflow skills for codebase explanation, diagnosis, planning, implementation, simplification, handoff, review, architecture improvement, and small planning prototypes. not a framework, not a ceremony generator, mostly a set of rails i kept wanting back. inspired by matt pocock's skills, superpowers, and built to work with vercel labs skills. fork it if your planning/review language is different. the useful parts should feel like shop tools, not house rules. after install ask explain how the workflow skills work . if the agent does not pick it up, be explicit: use explain workflow to show me how this workflow works . then try a concrete prompt: use plan work to plan this feature use implement work to implement this handoff explain how this code path works diagnose this failing test use review work to review this change use write handoff to prepare a handoff use improve architecture to find deepening opportunities use simplify work to simplify this module without changing behavior skills skill purpose explain workflow explain how to invoke the workflow without starting work by default. explain codebase map code areas, modules, callers, flows, tests, and terms without editing. diagnose issue find evidence backed causes; apply fixes only when explicitly authorized. use workflow route work to the smallest fitting workflow. plan work shape uncertain or substantial work, with an optional saved Plan. implement work implement bounded work from Plans or other inputs with evidence and fresh review. write handoff write concise fresh context handoffs with lifecycle separate from storage. review work read only review of Plans, changes, continuation rounds, or other scoped artifacts. improve architecture discover evidence backed architecture improvements without forcing a refactor workflow. simplify work simplify a bounded area while preserving intended behavior. plan prototype answer one planning question with a minimal throwaway visual or logic pr