{"id":51596842,"url":"https://github.com/jadmadi/skills","last_synced_at":"2026-07-11T19:30:20.244Z","repository":{"id":369617692,"uuid":"1236954647","full_name":"jadmadi/skills","owner":"jadmadi","description":"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.","archived":false,"fork":false,"pushed_at":"2026-07-06T05:27:26.000Z","size":70,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-06T07:09:49.416Z","etag":null,"topics":["adoo","assess","cloudflare","cpu-audit","d1","d1-audit","deconstruct","optimize","organize","skills-sh"],"latest_commit_sha":null,"homepage":"https://www.skills.sh/jadmadi","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jadmadi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-12T18:27:30.000Z","updated_at":"2026-07-06T05:29:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jadmadi/skills","commit_stats":null,"previous_names":["jadmadi/skills"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/jadmadi/skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jadmadi%2Fskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jadmadi%2Fskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jadmadi%2Fskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jadmadi%2Fskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jadmadi","download_url":"https://codeload.github.com/jadmadi/skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jadmadi%2Fskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35374165,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-11T02:00:05.354Z","response_time":104,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adoo","assess","cloudflare","cpu-audit","d1","d1-audit","deconstruct","optimize","organize","skills-sh"],"created_at":"2026-07-11T19:30:19.170Z","updated_at":"2026-07-11T19:30:20.231Z","avatar_url":"https://github.com/jadmadi.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Skills\n\nJad 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.\n\n[![skills.sh](https://skills.sh/b/jadmadi/skills)](https://skills.sh/jadmadi/skills)\n\n## Quickstart\n\n```bash\nnpx skills add jadmadi/skills\n```\n\nPick 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.\n\n## Skills\n\nOrganized 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).\n\n### [Engineering](skills/engineering/)\n\nDebugging, pre-ship checklists, and codebase documentation.\n\n- **[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.\n- **[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.\n- **[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.\n\n### [Cloudflare](skills/cloudflare/)\n\nAudits for Cloudflare Workers CPU usage and D1 database performance/billing.\n\n- **[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.\n- **[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.\n\n## For contributors\n\n```bash\n# Scaffold a new skill from the template\nscripts/create-skill.sh \u003cbucket\u003e \u003cskill-name\u003e\n\n# Quick local sanity check (frontmatter, name/description rules, body length)\nscripts/validate-skill.sh \u003cbucket\u003e/\u003cskill-name\u003e\n\n# List every skill in the repo\nscripts/list-skills.sh\n\n# Symlink every skill into this machine's agent config directories\n# (~/.claude/skills, ~/.config/devin/skills, ~/.agents/skills, etc.)\nscripts/link-skills.sh\n```\n\nSee [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.\n\n## Skill structure\n\nEach skill is a directory under `skills/\u003cbucket\u003e/\u003cname\u003e/` containing:\n\n- `SKILL.md` — instructions for the agent (required)\n- `scripts/` — helper scripts for automation (optional)\n- `references/` — supporting documentation loaded on demand (optional)\n- `assets/` — templates or files used in output (optional)\n\n## Credits\n\nThis repo's conventions were learned from others, not invented here:\n\n- **[mattpocock/skills](https://github.com/mattpocock/skills)** (Matt Pocock) — the bucket layout (`skills/\u003cbucket\u003e/\u003cname\u003e/`), 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.\n- **[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.\n- **[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.\n\nIf you're setting up your own skills repo, all three are worth reading directly.\n\n## License\n\nMIT\n\n## Author\n\nJad Madi — [github.com/jadmadi](https://github.com/jadmadi)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjadmadi%2Fskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjadmadi%2Fskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjadmadi%2Fskills/lists"}