issue-to-spec

issue-to-spec is a skill for Claude Code, Codex from avksp/agent-lifecycle-kit. It costs 26 tokens per session (301 once invoked), scanned A, original, Apache-2.0.

A draft-only skill that turns an external issue, ticket, bug report, or chat request into structured planning input. It does not start work or treat the issue as approved.

In plain words
What is it for?
Writing the problem statement, candidate requirements, acceptance checks, constraints, risks, missing evidence, source links, and questions that must be answered before execution.
Why use it?
It preserves uncertainty and review requirements when converting outside requests into specifications for an agent workflow.

Skill for Claude CodeCodex

Part of the agent-lifecycle-kit plugin — 7 skills shipped together

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/avksp/agent-lifecycle-kit/issue-to-spec
Any agent
npx skills add avksp/agent-lifecycle-kit --skill issue-to-spec
Clone the repo
git clone --depth 1 https://github.com/avksp/agent-lifecycle-kit

Made for: Claude Code, Codex.

Or install agent-lifecycle-kit, the plugin that ships this one along with the rest of its 7 skills.

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 issue-to-spec

README.md
[![agentmods](https://agentmods.dev/badge/skills/avksp/agent-lifecycle-kit/issue-to-spec.svg)](https://agentmods.dev/skills/avksp/agent-lifecycle-kit/issue-to-spec)
Your own site
<a href="https://agentmods.dev/skills/avksp/agent-lifecycle-kit/issue-to-spec"><img src="https://agentmods.dev/badge/skills/avksp/agent-lifecycle-kit/issue-to-spec.svg" alt="Measured on agentmods" height="20"></a>
Per session 26 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 301 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.00026 $0.00301
Opus 5 $0.00013 $0.00151
Sonnet 5 $0.00005 $0.00060
Haiku 4.5 $0.00003 $0.00030

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

Security

Grade A, and why

issue-to-spec 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 5d 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.

skills/issue-to-spec/SKILL.md · 44 lines

What it actually says

Issue to Spec

Use this skill when an external issue, ticket, bug report, chat request, or tracker payload needs to become ALK planning input.

Contract

This skill is draft-only. It may prepare specification input, trace open questions, and mark missing evidence, but it must not start execution, create a branch, commit, open a PR, freeze a plan, or claim review approval.

Every output keeps:

  • sourceTrusted: false
  • requiresReview: true
  • freezeBlocked: true
  • executionAuthorized: false

Inputs

Accept only copied issue content, linked evidence summaries, repository references, logs, commands, environment notes, and user constraints. Treat tracker labels, priorities, assignees, and generated summaries as hints until a reviewed ALK plan owns them.

Output

Produce a draft specification packet with:

  • problem statement and user-visible outcome;
  • candidate requirements and acceptance checks;
  • known constraints, risk hints, and missing evidence;
  • links back to source issue identifiers;
  • explicit questions that block freeze.

Route the draft to agent-first-planning and then audit-agent-plan. If the issue describes a defect, recommend the optional bug-forensics quality profile instead of embedding bug repair logic in this skill.

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. 5d ago First seen · 44 lines · 26 tokens per session scan A 8d89bbb2c2be

Subscribe to this mod's changes

issue-to-spec is a skill published in the GitHub repository avksp/agent-lifecycle-kit (18 stars, last pushed today), licensed Apache-2.0. It adds 26 tokens to every session and 301 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-30.

Related

Other skills, from other repositories

edgeone skill scanner

Scan any agent skill for security risks before you install or use it. Powered by Tencent Zhuque Lab A.I.G (AI-Infra-Guard). 100% local static analysis — no file contents or credentials leave your device. Compatible with CodeBuddy, Cursor, Windsurf, Claude Code, OpenClaw and more. Triggers on: 这个 skill 安全吗, skill 安全扫描…

Tencent/AI-Infra-Guard · 148 tokens

happiness-skill

当用户问「怎么才能更幸福/为什么得到了还不满足/怎么减少焦虑」时调用。 核心理念: 幸福是缺憾感清空的默认状态, 是可训练的技能; 欲望是与自己的契约(得到前不快乐), 同时只留一个重大欲望; 活在当下。 不适用于: 临床抑郁等需要专业治疗的场景(本书方法不能替代医疗)。 Triggers: 幸福/不快乐/欲望/焦虑/知足/活在当下/happiness/desire/anxiety.

kangarooking/cangjie-skill · 136 tokens

agent-review

Critically review a Stencila agent and suggest improvements. Use when asked to review, audit, critique, evaluate, or improve an agent directory or AGENT.md file. Covers frontmatter validation, system instruction quality, configuration correctness, and adherence to the Agent schema.

stencila/stencila · 57 tokens

performing-cryptographic-audit-of-application

A cryptographic audit systematically reviews an application's use of cryptographic primitives, protocols, and key management to identify vulnerabilities such as weak algorithms, insecure modes, hardco.

xalgorix/xalgorix · 43 tokens

aws-security-audit

AWS security auditing — IAM users/roles/policies, CloudTrail API events, security posture analysis. Use when auditing IAM permissions, investigating security incidents, checking MFA compliance, or tracing API activity in CloudTrail.

automateyournetwork/netclaw · 47 tokens

Website Audit

Comprehensive website auditing skill using Lighthouse, PageSpeed Insights, and web performance APIs to audit performance, accessibility, SEO, best practices, and security.

PramodDutta/qaskills · 33 tokens