use-case-specification

A guided process for writing a use-case specification: a document describing the business problem, users, and measurable success criteria for customizing an AI model.

In plain words
What is it for?
Use it as the first step in a model-customization plan to gather requirements, reuse or revise an existing specification, and confirm the final document.
Why use it?
It clarifies what the customized model must achieve before planning how to build or evaluate it.

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/awslabs/agent-plugins/use-case-specification
Any agent
npx skills add awslabs/agent-plugins --skill use-case-specification
Clone the repo
git clone --depth 1 https://github.com/awslabs/agent-plugins

Made for: Claude Code, Codex.

Per session 85 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 869 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.00085 $0.00869
Opus 5 $0.00043 $0.00434
Sonnet 5 $0.00017 $0.00174
Haiku 4.5 $0.00009 $0.00087

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

Security

Grade A, and why

use-case-specification 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 2d 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.

plugins/sagemaker-ai/skills/use-case-specification/SKILL.md · 80 lines

How it starts

The opening of the file, as written. The whole thing — 80 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Use Case Specification

Multi-turn conversation to gather use case details and produce a use case specification document.

Principles

  1. One thing at a time. Each response advances exactly one decision or collects one piece of information.
  2. Confirm before proceeding. Wait for the user to approve the spec before considering this skill complete.
  3. Infer, don't interrogate. Use what's already known from the conversation. Only ask when you truly can't infer.
  4. Do NOT ask about base model selection. Model selection is handled exclusively by the model-selection skill.

Workflow

Step 0: Check for Existing Spec

Before starting discovery, check if a *_use_case_spec.md file already exists in the project. If it does, present it to the user and ask whether they want to reuse it, modify it, or start fresh.

Phase 1: Discovery (1–3 turns)

Review what is already known from the conversation so far, then identify what is still missing. You need these three things:

  • What is the problem the user is trying to solve with model customization
  • Who will use the finetuned model and in what context
  • Which success criteria can be used to evaluate how well the custom model performs compared to the base model on a test set. Success criteria must be measurable by an LLM-as-a-Judge (e.g., response accuracy, tone adherence) — not things like latency or throughput.

Guidelines:

  • Infer as much as possible from what the user has already said
  • If the user gave examples, use them to fill gaps rather than asking again
  • Only ask clarifying questions when you cannot infer the information needed for Phase 2
  • If everything is already clear, say "You've given me a clear picture. I'll put together a use case specification now." and move to Phase 2.

⏸ Wait for user after each clarifying question.

Phase 2: Producing a Use Case Specification Document

  1. Save all generated artifacts under the project directory structure defined by the directory-management skill, if available.
  2. Synthesize the information you collected from the user into a Markdown document called [relevant_title]_use_case_spec.md containing the following fields (and only these fields):

Read the full file on GitHub · 80 lines

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. 2d ago First seen · 80 lines · 85 tokens per session scan A 6eb2f6426e64

Subscribe to this mod's changes

use-case-specification is a skill published in the GitHub repository awslabs/agent-plugins (876 stars, last pushed 5d ago), licensed Apache-2.0. It adds 85 tokens to every session and 869 once invoked, about $0.0004 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-30.

Related

Other skills, from other repositories

redshift-support-specialist

Amazon Redshift domain expertise for query optimization, operational reviews, and cost optimization on provisioned clusters and Serverless workgroups. Use when a user asks about Redshift query tuning, slow queries, disk spill, distribution/sort key issues, a Redshift health check or operational review, or Redshift…

aws/tools-for-devops-agent · 88 tokens

bedrock-adoption-readiness

Amazon Bedrock production readiness assessment covering IAM governance, data retention (ZDR), quota and capacity headroom, and operational observability across Standard Bedrock and Mantle surfaces. Use this skill when a user asks to review Bedrock readiness, assess Bedrock security posture, evaluate quota headroom…

aws/tools-for-devops-agent · 137 tokens

database-rds-devops

Database-level data-plane diagnostics for Aurora MySQL and Aurora PostgreSQL. Executes predefined read-only health check queries via RDS Data API to analyze buffer pool, connections, locks, replication, storage, performance, and index efficiency. Requires the rds-aidba MCP server for database-internal access beyond…

aws/tools-for-devops-agent · 75 tokens

eks-operation-review

Comprehensive Amazon EKS operational review aligned with the AWS EKS Best Practices Guide. Use this skill when a user asks to review, audit, or assess EKS clusters for best practices compliance, operational readiness, security posture, cost optimization, reliability, networking, scalability, or upgrade readiness.…

aws/tools-for-devops-agent · 99 tokens

investigation-cost-guardrail

Cost guardrail for AWS DevOps Agent that covers ALL AWS services and native agent tools. Before the agent makes any paid API call, this skill estimates cost, enforces budgets per investigation, detects expensive operations across all services (Athena queries, S3 scans, DynamoDB scans, SageMaker inference, PromQL…

aws/tools-for-devops-agent · 105 tokens

cis-aws-foundations-3.2.3

Ensure that RDS instances are not publicly accessible.

CyberStrikeus/CyberStrike · 21 tokens