agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

181 stars

Best use case

agent-ops-spec is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

Teams using agent-ops-spec should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/agent-ops-spec/SKILL.md --create-dirs "https://raw.githubusercontent.com/majiayu000/claude-skill-registry/main/skills/core/agent-ops-spec/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/agent-ops-spec/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How agent-ops-spec Compares

Feature / Agentagent-ops-specStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# Spec Management workflow

## Purpose

Capture, organize, and trace specifications/requirements so the agent can validate implementation against them.

## Location

All specs live in `.agent/specs/` with user-specified or auto-generated filenames.

## Procedure

### Creating a spec

1) Ask user for filename or generate one (e.g., `feature-<name>.spec.md`, `issue-<id>.spec.md`)
2) Use the spec template
3) Fill in sections from user input
4) Link spec to issue(s) in `.agent/issues/` via `spec_file:` field

### Validating against spec

1) Read the linked spec file
2) Create traceability checklist:
   - Each requirement → implementation location → test(s)
3) Include in critical review phase

## Template

Start from [spec template](./templates/spec.template.md).

Related Skills

adk-deployment-specialist

181
from majiayu000/claude-skill-registry

Deploy and orchestrate Vertex AI ADK agents using A2A protocol. Manages AgentCard discovery, task submission, Code Execution Sandbox, and Memory Bank. Use when asked to "deploy ADK agent" or "orchestrate agents". Trigger with phrases like 'deploy', 'infrastructure', or 'CI/CD'.

add-perspective

181
from majiayu000/claude-skill-registry

振り返り観点を追加するガイド。ユーザー指摘から学習し、類似問題を将来検出できるようにする。観点、perspective、チェック追加時に使用。

acc-create-specification

181
from majiayu000/claude-skill-registry

Generates DDD Specification for PHP 8.5. Creates reusable business rule objects for validation, filtering, and querying with composite pattern support. Includes unit tests.

ac-spec-parser

181
from majiayu000/claude-skill-registry

Parse and validate project specifications. Use when loading YAML/JSON specs, validating spec structure, extracting requirements, or converting between spec formats.

abstract-algebra-specialist

181
from majiayu000/claude-skill-registry

Expert in groups, rings, fields, and algebraic structures with applications to cryptography and number theory

abm-specialist

181
from majiayu000/claude-skill-registry

Эксперт ABM. Используй для account-based marketing, target account selection и personalized campaigns.

a11y-specialist

181
from majiayu000/claude-skill-registry

Expert in web accessibility (WCAG 2.1/2.2 AA/AAA compliance), ARIA patterns, keyboard navigation, screen reader testing, color contrast, focus management, and automated accessibility testing

Security Specialist

174
from majiayu000/claude-skill-registry

专注于应用安全、认证授权与合规性。

ux

159
from majiayu000/claude-skill-registry

This AI agent skill provides comprehensive guidance for creating professional and insightful User Experience (UX) designs, covering user research, information architecture, interaction design, visual guidance, and usability evaluation. It aims to produce actionable, user-centered solutions that avoid generic AI aesthetics.

UX Design & StrategyClaude

ontopo

159
from majiayu000/claude-skill-registry

An AI agent skill to search for Israeli restaurants, check table availability, view menus, and retrieve booking links via the Ontopo platform, acting as an unofficial interface to its data.

General Utilities

thor-skills

159
from majiayu000/claude-skill-registry

An entry point and router for AI agents to manage various THOR-related cybersecurity tasks, including running scans, analyzing logs, troubleshooting, and maintenance.

SecurityClaude

tech-blog

159
from majiayu000/claude-skill-registry

Generates comprehensive technical blog posts, offering detailed explanations of system internals, architecture, and implementation, either through source code analysis or document-driven research.

Content & DocumentationClaude