Skip to content

SkillMedev/engineering-workflow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

Engineering Workflow

For engineers using Claude: from test-first code to review, clean commit, PR & release. — built in-house by Skill Me.

Reach for this when you want the craft around a change to stay disciplined instead of rushed. It runs the whole arc: write code test-first with a full worked red-green-refactor cycle, enforce honestly strict TypeScript (the exact tsconfig flags plus a flag-by-flag migration path for loose codebases), self-review the diff as six ordered passes with concrete red flags, then turn it into a clean conventional commit, a reviewer-ready PR description, and a Keep-a-Changelog entry whose version bump follows mechanically from the categories - so the parts engineers get judged on come out consistent rather than improvised at the end.

If this is useful, star the repo — it's how we gauge what to build next.

Install

  • From the catalog: skillme.dev/pack/engineering-workflow — install the whole pack into Claude in one step.
  • With the skills CLI: npx skills add SkillMedev/engineering-workflow
  • Manually: copy any skills/<slug>/SKILL.md into your Claude skills directory.

Skills in this pack

  • Git Commit Writer — Generates conventional commit messages from diffs with scope, breaking change flags, and issue refs. (external — see source)
  • PR Description Writer — Turns a git diff into a structured pull request description with motivation, changes, and test plan. (external — see source)
  • Changelog Generator — Generate or update a repository CHANGELOG.md in Keep a Changelog format from git history - grouping commits since the last tag into Added/Changed/Deprecated/Removed/Fixed/Security, rewriting them as user-facing entries, and recommending the semantic version bump.
  • README Generator — Generates a complete, professional README from a codebase scan - badges, usage, API docs, contributing guide. (external — see source)
  • Code Review Checklist — Run a systematic multi-pass code review - correctness, design, security, performance, tests - and report findings ordered by severity with concrete, respectful suggestions.
  • TypeScript Strict Mode — Write and review TypeScript as if strict mode plus the hardening flags (noUncheckedIndexedAccess, exactOptionalPropertyTypes) are enforced, and migrate loose codebases to full strictness flag by flag without breaking the build.
  • TDD Expert — Drive development with strict Red-Green-Refactor discipline - write one failing test, write the minimum code to pass it, refactor on green - including test-list planning and a worked kata cycle.
  • Karpathy Behavioral Rules — Four hard rules that stop Claude from silently over-engineering, making wrong assumptions, or touching code it was never supposed to. (external — see source)

License

MIT — see LICENSE. Skills are portable SKILL.md files; the canonical copies live in the Skill Me catalog.

About

The git, review, and release workflow every senior engineer already uses.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors