skills.rest
ryan-mahoney
ryan-mahoneyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

spec

Generate a structured implementation spec and attach it to a GitHub issue.

Updated Mar 14, 2026
Search Tags:#planning#architecture#documentation#github#spec#issue#acceptance-criteria
One-click install
npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill spec-ryan-mahoney
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/ryan-mahoney/ryan-llm-skills/tree/main/skills/spec
Command: npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill spec-ryan-mahoney

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically generates a structured implementation spec for a requested feature and attaches it to a GitHub issue, ensuring a consistent planning artifact.

Core Features & Use Cases

  • Structured spec with sections such as problem statement, goals, architecture, acceptance criteria, notes, and implementation steps.
  • Attach to an existing GitHub issue when an issue number is provided, or create a new issue when none is specified.
  • Enforce a repeatable template to standardize specs across features and projects.

Quick Start

Create or update a GitHub issue with a complete implementation spec for the requested feature.

Frequently Asked Questions about spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an implementation spec for a GitHub issue?▼

You can attach an implementation spec to an existing issue by providing the issue number. If no issue number is specified, the Skill will automatically create a new GitHub issue and populate it with the structured spec.

What sections are included in a structured implementation spec?▼

A structured implementation spec includes sections for the problem statement, goals, architecture, acceptance criteria, notes, and implementation steps. This enforces a repeatable template to standardize feature requirements across projects.

How do I automate documentation for feature requirements in GitHub?▼

Automate documentation for feature requirements by generating a structured implementation spec attached to a GitHub issue. This ensures a consistent planning artifact is created whenever drafting specs for code-level tasks across a repository.

Can I create a new GitHub issue when no target issue is provided for the spec?▼

Yes, the Skill supports creating a new GitHub issue when no target issue is provided. It automatically opens a new issue and populates it with the complete implementation spec layout.

When should I use a structured spec for planning new features?▼

Use a structured spec when planning new features or changes, or when drafting specs for code-level tasks across a repository. It provides a reproducible spec layout to satisfy project requirements and standardize planning artifacts.

Related Skills

Explore More Software Engineering Skills→
danhannah94danhannah94

csdlc-issue

Draft structured GitHub issues from session context and create them with gh.

Community
Intermediate
hydrosolutionshydrosolutions
1

executing-issues

Execute GitHub issues from implementation plans with lifecycle status updates.

Official
Intermediate
richardnguyen0715richardnguyen0715

github-issues

Manage GitHub issues from the command line using gh or git tools.

Community
Intermediate
furqan90furqan90

spec-remix

Reuse validated Project Spec files to generate v1.1-conformant updated specs.

Community
Intermediate