https://github.com/jadmadi/skills
Jad Madi's agent skills for Claude Code, Cursor, Windsurf, Codex, and Devin -- ADOO problem-solving, a backend pre-flight checklist, codebase-artifact HTML docs, and Cloudflare Workers CPU/D1 audits.
https://github.com/jadmadi/skills
adoo assess cloudflare cpu-audit d1 d1-audit deconstruct optimize organize skills-sh
Last synced: 11 days ago
JSON representation
Jad Madi's agent skills for Claude Code, Cursor, Windsurf, Codex, and Devin -- ADOO problem-solving, a backend pre-flight checklist, codebase-artifact HTML docs, and Cloudflare Workers CPU/D1 audits.
- Host: GitHub
- URL: https://github.com/jadmadi/skills
- Owner: jadmadi
- License: mit
- Created: 2026-05-12T18:27:30.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-07-06T05:27:26.000Z (17 days ago)
- Last Synced: 2026-07-06T07:09:49.416Z (17 days ago)
- Topics: adoo, assess, cloudflare, cpu-audit, d1, d1-audit, deconstruct, optimize, organize, skills-sh
- Language: Shell
- Homepage: https://www.skills.sh/jadmadi
- Size: 68.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Skills
Jad Madi's agent skills — for Claude Code, Cursor, Windsurf, Codex, Devin, and any other agent that supports the [Agent Skills](https://agentskills.io/) format. Built from real engineering work, refined against real usage, published as I use them.
[](https://skills.sh/jadmadi/skills)
## Quickstart
```bash
npx skills add jadmadi/skills
```
Pick the skills you want and which agents to install them on. Skills are used automatically once installed — the agent reaches for them when a task matches.
## Skills
Organized into buckets under `skills/`. All skills below are model-invoked (the agent can reach for them on its own, based on the task, not just by typed name).
### [Engineering](skills/engineering/)
Debugging, pre-ship checklists, and codebase documentation.
- **[adoo](skills/engineering/adoo/SKILL.md)** — Structured problem-solving via the ADOO method (Assess, Deconstruct, Organize, Optimize) for bugs, refactors, and incidents where jumping straight to a fix is risky.
- **[pre-flight-check](skills/engineering/pre-flight-check/SKILL.md)** — Pre-commit / pre-deploy checklist for backend and full-stack changes: typecheck/lint gates, API response consistency, route ordering, schema checks, and result-checking. Ships as an adaptable template.
- **[codebase-artifact](skills/engineering/codebase-artifact/SKILL.md)** — Scan a codebase and produce a single self-contained HTML file documenting its architecture, user journey, component hierarchy, and key code patterns.
### [Cloudflare](skills/cloudflare/)
Audits for Cloudflare Workers CPU usage and D1 database performance/billing.
- **[cf-cpu-audit](skills/cloudflare/cf-cpu-audit/SKILL.md)** — Scan a Cloudflare Workers repo for operations that excessively consume CPU time: global scope misses, memory buffering, pure-JS crypto, blocking iterations, missing `waitUntil()` deferral.
- **[cf-d1-audit](skills/cloudflare/cf-d1-audit/SKILL.md)** — Scan a Cloudflare Workers repo for D1 patterns that inflate billing, risk timeouts, or cause consistency bugs: missing indexes, N+1 queries, unbatched round-trips, wildcard `SELECT`s, and more.
## For contributors
```bash
# Scaffold a new skill from the template
scripts/create-skill.sh
# Quick local sanity check (frontmatter, name/description rules, body length)
scripts/validate-skill.sh /
# List every skill in the repo
scripts/list-skills.sh
# Symlink every skill into this machine's agent config directories
# (~/.claude/skills, ~/.config/devin/skills, ~/.agents/skills, etc.)
scripts/link-skills.sh
```
See [AGENTS.md](AGENTS.md) for the full conventions (naming, description hygiene, cross-agent portability, when to add a new bucket) and [.out-of-scope/](.out-of-scope/) for additions that were deliberately rejected, and why.
## Skill structure
Each skill is a directory under `skills///` containing:
- `SKILL.md` — instructions for the agent (required)
- `scripts/` — helper scripts for automation (optional)
- `references/` — supporting documentation loaded on demand (optional)
- `assets/` — templates or files used in output (optional)
## Credits
This repo's conventions were learned from others, not invented here:
- **[mattpocock/skills](https://github.com/mattpocock/skills)** (Matt Pocock) — the bucket layout (`skills///`), per-bucket `README.md`s, `scripts/link-skills.sh` / `scripts/list-skills.sh`, and the [`.out-of-scope/`](.out-of-scope/) convention for recording rejected ideas instead of only in commit messages are all adapted directly from his repo. His [`writing-great-skills`](https://github.com/mattpocock/skills/blob/main/skills/productivity/writing-great-skills/SKILL.md) skill and its glossary also shaped how the skills here are written — description hygiene, cutting duplication, and the vocabulary for what makes a skill predictable rather than just plausible-sounding.
- **[vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills)** — the `skills.sh.json` grouping format and the general shape of this README (badge, "what it does / use when" summaries per skill) come from theirs.
- **[Agent Skills specification](https://agentskills.io/)** — the open format every skill here implements, and the source for the authoring best-practices this repo tries to follow.
If you're setting up your own skills repo, all three are worth reading directly.
## License
MIT
## Author
Jad Madi — [github.com/jadmadi](https://github.com/jadmadi)