Production-Ready AI Skill Engineering
awesome-skills
Not just prompt templates. A traceable five-layer system for designing, evaluating, and integrating Claude Code skills into real engineering workflows.
51 Installable
Skills
Skills
24 Design +
Eval Docs
Eval Docs
13 Five-Layer
Complete
Complete
347x Dev-Time
ROI
ROI
A Five-Layer Knowledge Chain
Each layer feeds the next — from abstract principles to measured, executable evidence.
bestpractice/ Methodology Design principles, evaluation framework, iteration patterns, and workflow integration rationale/ Design Logic Why each skill's gates, structure, and tradeoffs are designed the way they are skills/ Executable Skills 51 installable skill artifacts shaped by the methodology above evaluate/ Quantitative Proof Formal review reports with trigger accuracy, ROI, and regression data outputexample/ Real Outputs Actual artifacts from real tasks: PDFs, CI configs, test code, screenshots Quantitative, Not Anecdotal
Trigger accuracy, task performance, and token cost-effectiveness — measured across real scenarios with deterministic regression tests.
go-code-reviewer
347x
developer-time ROI
+36 pp signal-to-noise in subtle defect scenarios
Read report → google-search
+74pp
assertion pass rate
Structured evidence chains vs. unstructured ad-hoc search
Read report → unit-test
+38pp
assertion pass rate
Table-driven tests with boundary and concurrency hunting
Read report → 51 Installable Skills
24 ship paired design rationale and evaluation reports; 14 have complete five-layer coverage with real output examples. A selection is shown below.
Pipeline Backend Development
go-makefile-writer Design or refactor root Makefiles for Go with consistent fmt / test / lint / build gates git-commit Secret-scan + quality gates before commit, then standardized message generation create-pr High-quality PRs with multiple preflight gates and structured body content go-ci-workflow GitHub Actions CI for Go: Make-driven, locally consistent, caching and layered gates go-code-reviewer Defect-first automated code review — real bugs and regressions, not style nits security-review Exploitability-first review across auth, input, dependencies, and container risks
Testing Testing & Validation
unit-test Table-driven tests with boundary hunting, mapping loss, and concurrency edge cases tdd-workflow Practical TDD with Red→Green→Refactor evidence and risk-path coverage api-integration-test Real runtime config, explicit gates, timeout / retry safety, and failure diagnosis e2e-test E2E tests for key user journeys, balanced for CI integration and reliability fuzzing-test Go fuzz tests with applicability gate — refuses low-value targets upfront thirdparty-api-integration-test External contract validation with explicit run gates and timeout controls systematic-debugging Root-cause analysis required before fixes — no guess-driven debugging loops
Research Search & Research
Docs Documentation & Planning
writing-plans Evidence-backed implementation plans with dependency graphs and post-write review loops update-doc Docs-drift detection and evidence-backed README synchronization readme-generator Project-shape detection and evidence-based generation across service / lib / CLI / monorepo tech-doc-writer Runbooks, API docs, RFCs — type classification, audience analysis, anti-staleness rules
A Complete Engineering Pipeline
Backend skills compose into an end-to-end flow from first line of code to merged PR.
◆
Coding
⬣
Write / Fix Tests
unit-test · tdd-workflow · api-integration-test · e2e-test
⬣
make fmt / lint
go-makefile-writer
⬣
git commit
git-commit
⬣
create PR
create-pr
⬣
CI + Review
go-ci-workflow · go-code-reviewer · security-review
✓
Human Review + Merge
Three Steps to Your First Skill
01
Browse and choose a skill
Find a skill in the grid above, or start with google-search. Every skill is a plain SKILL.md — a small frontmatter contract plus a body of mandatory gates:
---
name: google-search
description: Use when the user wants help finding information through
Google-style web search and expects more than raw links … classify
the goal, generate precise queries, cross-check key claims, return a
concise conclusion plus reusable search strings.
allowed-tools: Read, Grep, Glob, WebFetch
---
## Mandatory Gates
Gates execute in strict serial order. Any gate failure blocks the next.
### 1) Scope Classification Gate
### 2) Ambiguity Resolution Gate
### 3) Evidence Requirements Gate
### 4) Language Detection Gate
… # 8 gates totalRead the paired rationale doc to see why it is built this way.
02
Install it
# Recommended — skills CLI (Claude Code, Cursor, Copilot, 15+ agents)
npx skills add johnqtcg/awesome-skills --skill <name> -g
# Or copy the directory manually
cp -r skills/<name> .claude/skills/<name> # this project
cp -r skills/<name> ~/.claude/skills/<name> # all projects03
Claude Code activates it automatically
When the task matches, Claude Code invokes the skill — no manual configuration. For a deeper study, read the full methodology: Best Practice →
Where to Start Reading
- 1 bestpractice/README.md Build the overall picture of the methodology
- 2 rationale/google-search/design.md Read the design rationale for a concrete skill
- 3 skills/google-search/SKILL.md Open the executable skill artifact itself
- 4 evaluate/google-search-skill-eval-report.md Read the quantitative evaluation report
Add or Improve a Skill
From a one-line typo fix to a full new skill — contributions are welcome, held to the same five-layer standard the repository holds itself to.
Contribution guide → What a complete skill ships with — SKILL.md + rationale + evaluation + output example — plus naming and layout rules. Open an issue → Propose a new skill or report a bug with the guided templates, or pick up a good-first-issue. PR template → A structured summary / changes / test-plan checklist. Every PR runs the golden-fixture regression suite in CI before merge. Edit any page directly → Every doc page here carries an ✎ edit link (top-right) that opens its source on GitHub — the fastest path for a small fix.