Skills

Various project-agnostic engineering agent skills.

Table of contents

• Install with skills.sh
• Available skills
  • Cleanup tests
  • File PR
  • Babysit PR
  • Review PR breaking changes
  • Tight review
  • Update docs
  • SSH

Install with skills.sh

Install all skills from this repository:

npx skills add umaraziz0/skills

Install to specific agents only (e.g opencode):

npx skills add umaraziz0/skills -a opencode

List available skills before installing:

npx skills add umaraziz0/skills --list

Available skills

Cleanup tests

Evidence-driven test cleanup with an exhaustive whole-suite audit by default. Always audits first, then requires confirmation before safe test-only edits; explicit narrowed forms support files, diff, and feature scopes. Reviews tautological, low-value, duplicate, snapshot, flaky, slow, and unreadable tests without changing production code.

/cleanup-tests
/cleanup-tests files tests/auth_test.rb
/cleanup-tests diff HEAD~1
/cleanup-tests feature authentication

File PR

Publish the current branch’s committed history (leave the starting dirty tree alone), open or reuse a PR to the default branch, fill docs/pull_request_template.md when present (and write the body with technical-writing when that skill is installed).

/file-pr

Babysit PR

Watch CI for the current branch’s existing PR. Diagnose failing checks and apply up to three scoped fix-and-push attempts until required checks are green. Leave starting dirty paths uncommitted.

/babysit-pr

Review PR breaking changes

Post-merge ops checklist for a user-provided GitHub PR (URL, #n, or owner/repo#n). Flags migrations, dependency bumps, env/key changes, seeders, and queue-worker restarts (e.g. Laravel Jobs). Deploy cheat sheet only — does not merge, approve, or run migrate/seed/install.

/review-pr-breaking <PR>

Tight review

Read-only implementation review. Starts from a commit, explicit file roots, or a feature/domain, then traces relevant current working-tree behavior. Checks correctness, spec/ticket compliance, documented repository standards, and unnecessary complexity in separate lanes; does not mutate, approve, or request changes. A lean combination of:

• /ponytail-review - for tight coding principles
• /code-review - for spec and style adherence
• /caveman-review - for simplified code review output

/tight-review HEAD
/tight-review files src/auth.ts src/routes.ts
/tight-review authentication

• Commit ref: use files changed by that commit as discovery seeds, then review their current implementation. The commit is not a diff base or historical snapshot.
• Files: trace current implementation from explicit roots.
• Feature/domain: discover a bounded implementation scope, then trace it.

Update docs

Reconcile all tracked Markdown and MDX documentation with package manifests, lockfiles, configuration, and current implementation. The skill updates proven drift with technical-writing when that skill is installed, and leaves code and dependency files unchanged. It reports ambiguous claims without guessing.

/update-docs

SSH

Thin SSH wrapper. Ask once per session, then load only SSH_* lines from project .env (SSH_HOST, SSH_USERNAME, SSH_PRIVATE_KEY_PATH) — never source the whole file. Run remote commands, browse the filesystem, and debug the host. Destructive commands require explicit confirmation before run.

/ssh