heaptrace-qa

Heaptrace Developer Skills

105 structured skills for development teams — from planning to release.
Every skill comes with step-by-step guides, flow diagrams, checklists, templates, and anti-patterns.

📖 Browse Skills

---

Quick Setup

Claude Code Plugin (Recommended)

This repo is a native Claude Code plugin. Install individual packs directly from within Claude Code:

1. Open Claude Code in your project
2. Run /install-plugin and point it to this repo, or add to your settings.json:

{
  "plugins": [
    { "source": "https://github.com/heaptracetechnology/heaptrace-skills", "plugin": "heaptrace-dev" },
    { "source": "https://github.com/heaptracetechnology/heaptrace-skills", "plugin": "heaptrace-architect" }
  ]
}

Install only the packs your team needs. Each plugin is listed in .claude-plugin/marketplace.json.

---

Manual Setup (Claude Code & Cursor)

Clone and copy individual plugin skills to your tool's skills directory.

git clone https://github.com/heaptracetechnology/heaptrace-skills.git

Claude Code

# Copy a specific plugin's skills (e.g. developer pack)
cp -r heaptrace-skills/plugins/heaptrace-dev/skills/* your-project/.claude/skills/

# Copy all plugins at once
for plugin in heaptrace-skills/plugins/*/; do
  cp -r "$plugin/skills/"* your-project/.claude/skills/
done

Path: .claude/skills/<skill-name>/SKILL.md

Cursor

# Copy a specific plugin's skills
cp -r heaptrace-skills/plugins/heaptrace-dev/skills/* your-project/.cursor/skills/

Path: .cursor/skills/<skill-name>/skill.md

Add to .gitignore

Skills are personal tools — don't commit them to your project repo:

echo ".claude/skills/" >> .gitignore
echo ".cursor/skills/" >> .gitignore

---

What Are Skills?

Skills are structured instruction files that guide AI coding assistants through specific development tasks. Instead of writing prompts from scratch, skills give consistent, battle-tested processes your entire team can follow.

Client gives a task
    → /suggest       (what's missing? what can we add?)
    → /feature-plan  (break it down, plan it)
    → /feature-work  (build it end-to-end)
    → /code-review   (catch issues before PR)
    → /smart-commit  (clean commit message)
    → /release-notes (client-ready changelog)

---

Skill Packs

🔷 Developer (13 skills)

The daily toolkit for every developer.

Skill	What It Does
feature-plan	Break requirements into tasks, mockups, and flow diagrams
feature-work	Build end-to-end: DB → API → UI → Test
find-fix	Trace bugs: reproduce → isolate → root cause → fix → verify
smart-commit	Generate semantic commit messages (WHY, not WHAT)
suggest	Spot gaps and suggest improvements clients didn't ask for
code-review	8-pass review: logic, security, perf, naming, tests
test-gen	Generate tests that catch real bugs, not just pass
explain	Understand any code before you touch it
sec-audit	OWASP Top 10, secrets scan, dependency check
release-notes	Turn git history into client-ready changelogs
quick-plan	Rapid planning for small, well-scoped tasks
quick-work	Fast execution mode for clearly defined tasks
code-standards	Enforce and document team coding standards

🟡 Lead Engineer (9 skills)

For tech leads managing teams and making architectural decisions.

Skill	What It Does
sprint-plan	Break epics into sprints with estimates and assignments
arch-review	Audit architecture for scalability, coupling, SPOFs
tech-debt-audit	Find and prioritize tech debt across the codebase
incident-response	Structured triage, root cause analysis, postmortem
pr-strategy	Split large features into reviewable PRs
onboard-dev	Generate onboarding guide for new team members
perf-audit	Profile slow endpoints, N+1 queries, memory leaks
decision-doc	Write Architecture Decision Records (ADRs)
message-craft	Craft clear technical messages and stakeholder updates

🟣 Technical Architect (8 skills)

System design, API contracts, and infrastructure planning.