Skip to content

Repository files navigation

Agent Engineering Skills (for Agent Zero)

Production-grade engineering skills for Agent Zero, adapted from addyosmani/agent-skills (MIT).

Nine universal skills covering the full software development lifecycle, plus six reference checklists as supporting material.

Skills

Skill Trigger
spec-driven-development Start of new project/feature; requirements unclear
planning-and-task-breakdown Before implementation; large or multi-step work
incremental-implementation Building a feature; one slice at a time
test-driven-development Tests as proof; before writing code
debugging-and-error-recovery Tests fail, builds break, behavior unexpected
code-review-and-quality Reviewing a PR, plan, or code change
code-simplification Refactoring for clarity without behavior change
documentation-and-adrs Capturing decisions and rationale
doubt-driven-development Questioning assumptions; avoiding premature commitment

Reference Checklists (references/)

  • testing-patterns.md
  • security-checklist.md
  • performance-checklist.md
  • accessibility-checklist.md
  • observability-checklist.md
  • orchestration-patterns.md

These are loaded on demand by the relevant skills, not auto-injected.

Install

Already in place

This plugin is installed at /a0/usr/plugins/agent_engineering_skills/.

Agent Zero auto-discovers skills under usr/plugins/*/skills/ at startup. If the plugin was just added, toggle it off and on in the Plugins dialog (or restart the UI) to trigger a rescan.

Verify discovery

skills_tool action=list   # via Agent Zero UI or the skills_tool

You should see all 9 skills listed.

Validate

python3 /a0/usr/plugins/agent_engineering_skills/scripts/validate-skills.py

The validator enforces the skill-anatomy contract: every SKILL.md must have valid YAML frontmatter (name and description) and required sections (Overview, When to Use, Process / equivalent, Common Rationalizations, Red Flags, Verification). Warnings are non-fatal; errors must be fixed before shipping a new version.

Structure

agent_engineering_skills/
├── plugin.yaml                  # manifest
├── default_config.yaml          # defaults
├── README.md                    # this file
├── LICENSE                      # MIT (preserved from upstream)
├── skills/                      # 9 SKILL.md files
├── references/                  # 6 checklist .md files
└── scripts/
    └── validate-skills.py       # anatomy validator

Attribution

These skills are adapted from addyosmani/agent-skills by Addy Osmani (Google Chrome, Lighthouse), MIT licensed.

The original repository ships 26 skills, 4 agent personas, 8 slash commands, 6 references, and validation hooks for Claude Code, Cursor, Gemini CLI, Windsurf, OpenCode, Copilot, Kiro, Codex, and "any agent accepting system prompts or instruction files."

This plugin:

  • Adapts 9 of the 26 skills (universal engineering disciplines).
  • Drops the platform-specific concepts (slash commands, agents/, hooks/) that don't map to Agent Zero's mechanisms.
  • Reuses the validation contract as a Python script (upstream ships Node.js).
  • Preserves the substantive content of each skill unchanged — only frontmatter and trigger phrasing were reviewed for Agent Zero's skills_tool discovery model.

The remaining 17 skills (security-and-hardening, performance-optimization, frontend-ui-engineering, api-and-interface-design, git-workflow-and-versioning, ci-cd-and-automation, shipping-and-launch, deprecation-and-migration, observability-and-instrumentation, browser-testing-with-devtools, context-engineering, source-driven-development, idea-refine, interview-me, using-agent-skills) can be added later on request.

License

MIT. See LICENSE. Copyright (c) 2025 Addy Osmani (original work); adaptation copyright held by this plugin's contributors.

Author & Support

Built and maintained by Shawn5cents (GitHub).

If this plugin saves you time or improves your engineering workflow, you can support its development:

Buy Me a Coffee

Upstream Attribution

These skills are adapted from addyosmani/agent-skills by Addy Osmani, MIT licensed. See the LICENSE file for full attribution. Original copyright (c) 2025 Addy Osmani; this adaptation copyright (c) 2026 Shawn5cents.

About

Production-grade engineering skills for Agent Zero — adapted from addyosmani/agent-skills

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages