amby-specify

amby-specify is a skill for Claude Code, Codex from ambystechcom/AmbyKit. It costs 23 tokens per session (499 once invoked), scanned A, original, MIT.

A feature-specification writer that turns an idea into user stories, plain acceptance tests, requirements, and measurable success criteria. User stories describe who needs something and why; acceptance tests define when it is complete.

In plain words
What is it for?
Use it to create a draft specification before planning or building a feature.
Why use it?
It turns an unfinished idea into a shared description that developers and reviewers can check. Unknown details are marked for clarification instead of being silently guessed.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/ambystechcom/ambykit/amby-specify
Any agent
npx skills add ambystechcom/AmbyKit --skill amby-specify
Clone the repo
git clone --depth 1 https://github.com/ambystechcom/AmbyKit

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for amby-specify

README.md
[![agentmods](https://agentmods.dev/badge/skills/ambystechcom/ambykit/amby-specify.svg)](https://agentmods.dev/skills/ambystechcom/ambykit/amby-specify)
Your own site
<a href="https://agentmods.dev/skills/ambystechcom/ambykit/amby-specify"><img src="https://agentmods.dev/badge/skills/ambystechcom/ambykit/amby-specify.svg" alt="Measured on agentmods" height="20"></a>
Per session 23 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 499 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00023 $0.00499
Opus 5 $0.00012 $0.00249
Sonnet 5 $0.00005 $0.00100
Haiku 4.5 $0.00002 $0.00050

Measured 4d ago against content hash cb790fdd9b0b, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

amby-specify scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/amby-specify/SKILL.md · 29 lines

What it actually says

Act as the Product Manager in @.amby/roles/pm.md and say so in your first line. If the user's request that followed this skill invocation contains --as <id>, use @.amby/roles/<id>.md instead; if that file is missing, stop and list the files in .amby/roles/.

Write a specification for: the user's request that followed this skill invocation

Context: read @.amby/constitution.md and the structure of @.amby/templates/spec.md only. Do not read other specs.

  1. Create the feature dir specs/NNN-slug/ (next number, kebab-slug from the title) and write spec.md following @.amby/templates/spec.md.
  2. Define user stories (US-#): role / capability / benefit, a priority (P1/P2/P3), why that priority, an independent-test statement, and depends-on/blocked-by if any. Set status: draft.
  3. Write acceptance criteria in Given/When/Then per story.
  4. Write functional requirements (FR-###) in EARS notation (SHALL / WHEN / WHILE / IF-THEN / WHERE). Each must be testable.
  5. Write measurable, tech-agnostic success criteria (SC-###).
  6. Capture WHAT/WHY only — no technology choices. Flag every unknown inline as [NEEDS CLARIFICATION: …] instead of guessing.
  7. If .amby/config.json has "worktrees": true and this is a git repo, run ambykit worktree NNN-slug (the only command to run) and tell the user to continue in .worktrees/NNN-slug/. Otherwise skip this step (say why if isolation was enabled but git is absent).

Keep it tight. Reference the constitution by principle number where relevant; don't restate it.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 29 lines · 23 tokens per session scan A cb790fdd9b0b

Subscribe to this mod's changes

amby-specify is a skill published in the GitHub repository ambystechcom/AmbyKit (2 stars, last pushed 8d ago), licensed MIT. It adds 23 tokens to every session and 499 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

hns-lsel-curator

Local Self-Evolution Loop (LSEL) curator — the CLUSTER + drain engine for the GOOS-local PROPOSE→APPLY seam closure (SPEC-LSEL-LOCAL-EVOLUTION-001). Companion-offset drain of .moai/lessons-inbox.jsonl with a drain-side severity filter that drops the 65% Bash-timeout/sandbox noise, eventkey clustering with a frequency…

modu-ai/moai-adk · 135 tokens

moai-foundation-core

Provides MoAI-ADK foundational principles including TRUST 5 quality framework, SPEC-First DDD methodology, delegation patterns, progressive disclosure, agent catalog reference, and token budget management (absorbed from moai-foundation-context). Use when referencing TRUST 5 gates, SPEC workflow, or context window…

modu-ai/moai-adk · 68 tokens

hns-lsel-applier

Local Self-Evolution Loop (LSEL) APPLY engine — the playback-only consumer of approved decision.json records that drives .moai/hooks/lsel-apply.sh for the GOOS-local PROPOSE→APPLY seam closure (SPEC-LSEL-LOCAL-EVOLUTION-001 M3). Reads an approved decision.json, validates the target against the frozen allowlist…

modu-ai/moai-adk · 181 tokens

moai-domain-database

Database specialist covering PostgreSQL, MongoDB, Redis, Oracle, and cloud database platforms (Neon, Supabase, Firestore). Use for schema design, query optimization, indexing strategies, data modeling, or cloud database selection. Cloud vendor guide absorbed from moai-platform-database-cloud.

modu-ai/moai-adk · 64 tokens

moai-workflow-ddd

Domain-Driven Development workflow specialist using ANALYZE-PRESERVE-IMPROVE cycle for behavior-preserving code transformation. Use when refactoring legacy code or reducing technical debt safely.

modu-ai/moai-adk · 44 tokens

hns-workflow-ci-loop

Unified CI watch + auto-fix loop skill. Polls gh pr checks after /moai sync PR creation, classifies required vs auxiliary failures, attempts safe automated patches (max 3 iterations), and escalates semantic failures to the user. Use for CI loop workflow — NOT for general loop iteration patterns (see…

modu-ai/moai-adk · 76 tokens