Agent Skills

A collection of agent skills that extend capabilities across debugging, testing, and development workflow.

Install an individual skill with:

npx skills@latest add susomejias/skills/<skill-folder>

Skills

Debugging & Investigation

Skill	Description	Install
systematic-debugging	Four-phase debugging framework: root cause investigation, pattern analysis, hypothesis testing, implementation	npx skills@latest add susomejias/skills/systematic-debugging
root-cause-tracing	Trace bugs backward through the call stack to find the original trigger and fix the source instead of the symptom	npx skills@latest add susomejias/skills/root-cause-tracing
find-buggy-commit	Find the exact commit that introduced a bug using binary search. Autonomous mode (auto-testing) or interactive mode (step-by-step)	npx skills@latest add susomejias/skills/find-buggy-commit

Development Workflow

Skill	Description	Install
git-commit	Create clean git commits with emoji conventional commit messages, staged-file awareness, and split guidance	npx skills@latest add susomejias/skills/git-commit
testing	Pragmatic testing guidance with integration-first bias, behavior-focused assertions, and lighter use of mocks	npx skills@latest add susomejias/skills/testing

Planning

Skill	Description	Install
write-prd	Create a PRD through user interview, codebase exploration, and module design. Saves to .prds/ as a dated markdown file	npx skills@latest add susomejias/skills/write-prd

Strategy & Problem Solving

Skill	Description	Install
systems-thinker	Tackle wicked/strategic problems by finding the structural leverage beneath the symptom — iceberg depth, feedback loops, second-order effects (of the obvious fix and your own), irreducible tradeoffs — then deliver a concise, decision-first intervention right-sized to the problem	npx skills@latest add susomejias/skills/systems-thinker

Refactoring

Skill	Description	Install
zero-tech-debt	Rework a change as if the intended UX and architecture existed from day one: delete compatibility cruft, collapse mode flags, and reshape around the final product surface	npx skills@latest add susomejias/skills/zero-tech-debt

Security

Skill	Description	Install
npm-security-best-practices	Supply-chain hardening for any npm-ecosystem project (npm, pnpm, yarn, bun): lifecycle scripts, cooldown, lockfile-lint, deterministic installs, provenance, dependency confusion	npx skills@latest add susomejias/skills/npm-security-best-practices

Structure

Each skill lives in a top-level folder and contains a required SKILL.md file with optional supporting resources (reference docs, scripts).