WayToClawEarn
Medium impactHacker News

Google engineer Addy Osmani releases "Agent Skills": AI programming agents require engineer discipline

Google engineer Addy Osmani released the open source project "Agent Skills", which provides 21 standardized skills for AI programming agents, covering the entire process of specification writing, test-driven development, and code review. GitHub has received 27,862 Stars.

WayToClawEarn EditorialPublished May 5, 2026Updated Aug 8, 2026

Editorial review of public sources · AI-assisted drafting. How we work · Original source

Core conclusion

On May 3, 2026, Google engineer Addy Osmani released the open source project "Agent Skills", which provides a complete engineering skills framework for AI programming agents. The project is buzzing on Hacker News and has received 27,862 stars on GitHub.

Core claim: AI programming agents are junior engineers who are extremely capable but have no engineering intuition - they are good at writing code, but naturally skip the hidden key work of senior engineers: writing specifications, designing test cases, doing code reviews, and controlling the scope of changes. The Agent Skills project attempts to put the “scaffolding of senior engineers” back into the decision-making process of AI agents.

Key Points

  • Release time: 2026-05-03
  • Affected objects: AI programming tool users (Claude Code / Cursor / Copilot / Codex), automation developers, technical team leaders
  • Core changes: From "making AI write fast" to "making AI write well" - constraining AI agent behavior through a standardized skills framework

Background and trigger events

As AI programming tools such as Claude Code, Cursor, GitHub Copilot, and OpenAI Codex enter the mainstream, a common dilemma has arisen in the developer community: AI-generated code is extremely fast but of varying quality. The code can run, but it lacks test coverage, security review, and architectural thinking.

Addy Osmani, an engineering manager on the Google Chrome team, wrote in a blog post: "AI programming agents are junior engineers who are extremely capable but have no engineering intuition - they have no idea of work beyond code diff."

This sentence received 82 discussion points on Hacker News, and a large number of developers shared similar experiences: AI-generated code performs well in the rapid prototyping stage, but requires a lot of manual repair in the production environment.

SEO: AI Programming Agent, Agent Skills, Addy Osmani, AI Code Quality GEO: starting with TL;DR, precise number + date extra points

Agent Skills six life cycles

The project has designed 21 skills around the complete development process of the AI agent, distributed in six stages:

StageCore SkillsPurpose
Specificationspec-driven-development, api-and-interface-designLet AI think about what to do before writing code
Planning and Designincremental-implementation, scope-disciplineBreak down tasks and control the scope of changes
Build implementationtest-driven-development, code-simplificationWrite tests first and then write implementation
Test Verificationcode-review-and-quality, security-and-hardeningAutomated code review and security scanning
Release Deliveryci-cd-and-automation, changelog-generationContinuous integration/deployment automation
Continuous Optimizationperformance-optimization, technical-debt-managementPerformance optimization and technical debt management

Each skill provides standardized slash commands, including /spec, /plan, /build, /test, /review, /ship, /code-simplify, etc., which can be installed directly into Claude Code or copied to any AI programming tool as a Markdown specification guide.

Five design principles

Osmani set five core design principles for Agent Skills:

  1. Process is better than document - Workflow should have checkpoints, not long talks
  2. Anti-rationalization form - Common AI excuses have pre-written rebuttals (such as "This task is too simple and does not require specifications" → "The acceptance criteria still apply")
  3. Verification is non-negotiable – Every skill must ultimately have verifiable evidence
  4. Progressive Loading - Load corresponding skills according to the development stage, not all at once
  5. Scope Discipline - "Only move what you are asked to move."

Among them, the "anti-rationalization form" has attracted the most attention - Osmani calls it "pre-written lies that the AI agent has not yet spoken." For example, when an agent tries to skip code review, the form will tell it directly: "Code review is not optional, and even simple changes require a second pair of eyes."

AI

Three ways to use

Agent Skills supports three access modes:

ModeApplicable ScenarioOperation Method
Direct InstallClaude Code usersInstall from GitHub marketplace
Markdown ImportCursor/Gemini CLI/Codex usersImport skill files as spec guides
Pure readingTechnical team managementNo installation, read directly as team best practices

This flexible design makes the project not only a tool, but also a methodology.

Implications for AI automation workers

The value of Agent Skills extends beyond Claude Code users—it reflects an important trend shift in the field of AI programming agents: from the pursuit of speed to the pursuit of quality.

For developers using n8n, OpenClaw, or Make.com to build automated workflows, the same principles apply:

  • Automated processes should also have specifications and testing links
  • AI-generated workflow configurations require manual review
  • Scope control reduces unexpected API calls and fees

Related extended information

Tool entry

Tools and platforms covered in this article: Claude Code, ChatGPT, GitHub, Cursor, n8n, OpenClaw, Hermes Agent

Internal link guidance

View source →

Disclaimer: this site shares educational insights only, for inspiration and reference. No outcome guarantee; external execution and decisions are your own responsibility.