<- all tokdocs

Addy Osmani's agent-skills Repo: 25 Free Skills for Coding Agents

By , founder of Mavric and Apso

View on TikTok ->

Addy Osmani's agent-skills repo is a free, MIT-licensed pack of instruction files that teach coding agents an engineering workflow, from planning through shipping. It ships 25 skills: 24 lifecycle skills plus one meta-skill. The repo is real and works as described, but it launched in February 2026, so it is not new.

A TikTok from @nateherkai (Nate Herk) pitches it as "Someone just turned an entire software engineering playbook into 24 free AI skills." Most of that holds up. The details below show where the video's framing differs from the repo.

What is the agent-skills repo?

The repo lives at addyosmani/agent-skills on GitHub. Each skill is a folder with a SKILL.md file that tells an agent how to approach one kind of task, such as test-driven development, security hardening or performance work.

The README groups the skills by lifecycle stage:

  • Meta: discover which skill applies
  • Define: clarify what to build
  • Plan: break it down
  • Build: write the code
  • Verify: prove it works
  • Review: quality gates before merge
  • Ship: deploy with confidence

The README cites "Software Engineering at Google" and Google's engineering practices guide as sources. Neither the README nor the author's blog post calls the repo a "playbook." That word comes from the video.

Who is Addy Osmani?

The video names him ("It's Addy Osmani's agent skills repo") but never says where he works. His GitHub bio reads "Member of Technical Staff, Anthropic." His May 3, 2026 blog post describes him as a Member of Technical Staff at Anthropic working on Claude Code, after more than 14 years at Google.

Some secondary coverage still calls him a "Google Chrome engineer," and the company field on his GitHub profile still reads "Google." Those reflect his previous role. The repo ships a .claude-plugin directory, so his current employer is relevant.

Is it 24 skills or 25?

Both numbers appear in the README. The heading reads "All 25 Skills," and the text below it says the pack includes "25 skills total," made up of "24 lifecycle skills plus the using-agent-skills meta-skill." The video's "24" is the lifecycle count. The install command pulls all 25.

The count has grown over time, which is why older articles disagree. Eighteen skill folders date to launch day, February 15, 2026. Seven arrived later:

  • code-simplification on March 6, 2026
  • deprecation-and-migration on March 28, 2026
  • source-driven-development on April 8, 2026
  • doubt-driven-development on May 7, 2026
  • interview-me on May 10, 2026
  • observability-and-instrumentation on June 9, 2026
  • constraint-driven-development on August 8, 2026

A DEV Community article counted 19 skills, and the author's May 3 post said "twenty skills." The 24-lifecycle figure has been accurate since August 8, 2026.

Is the repo new?

It is not. The video says "someone just turned" the playbook into skills, but GitHub records the repo as created on February 15, 2026. That is eight months before the video was posted on October 16, 2026.

By the author's May 3 post it had passed 27,000 stars. When the repo was checked on October 19, 2026, it showed 108,523 stars, 11,309 forks and 702 commits.

How to install agent-skills

The README's quick start is one command:

npx skills add addyosmani/agent-skills

The comment next to it says it will "install all 25 skills." The README lists support for Claude Code, Cursor, Codex, Gemini CLI, Antigravity CLI, Windsurf, OpenCode, GitHub Copilot, Kiro IDE and CLI, and Command Code.

The video tells viewers to DM the word "SKILLS" on Instagram to get "it." The repo is public at github.com/addyosmani/agent-skills, so you do not need the DM to get the skills.

What does the performance-optimization skill do?

The video uses this skill as its example. It says the agent "measures the site first, it finds the actual bottleneck, it fixes the specific problem, and then tests it again to prove that the change actually worked."

That matches the skill file closely. Its overview opens with "Measure before optimizing. Performance work without measurement is guessing." The workflow has five steps:

  1. MEASURE: establish baseline with real data
  2. IDENTIFY: find the actual bottleneck (not assumed)
  3. FIX: address the specific bottleneck
  4. VERIFY: measure again; keep or revert
  5. GUARD: add monitoring or tests to prevent regression

The video covers steps 1 through 4 and skips step 5. It also understates step 4. The file says "A fix is a hypothesis until you re-measure," requires re-measuring "the way you measured the baseline: same command, same conditions, same fixed budget," and rules that "'Neutral' is a revert, not a keep."

What is a SKILL.md file?

The skills follow a format Anthropic defined. Its October 16, 2025 engineering post describes skills as "organized folders of instructions, scripts, and resources that agents can discover and load dynamically to perform better at specific tasks." Each skill is a directory with a SKILL.md file that "must start with YAML frontmatter that contains some required metadata: name and description."

Anthropic published Agent Skills "as an open standard for cross-platform portability" on December 18, 2025. The repo is one large pack written to that format.

Is it safe to install?

The license is MIT, so it is free to use. Anthropic's docs add a caution that applies to any skill pack: "Use Skills only from trusted sources," and "Treat like installing software." A skill's instructions and scripts run with whatever access your agent has.

Installing this pack adds 25 instruction files, plus hooks and commands, to your agent's path.

Bottom line

The repo is real, free under MIT, and ships 25 skills, 24 of them lifecycle skills. It launched on February 15, 2026, eight months before the video called it new. The video's description of the performance skill is accurate but leaves out its final GUARD step. Its author works at Anthropic on Claude Code, which the video does not mention.

Sources

Published October 16, 2026. Based on a TikTok by @nateherkai. Full video notes (markdown)