specops-analysis

Extract implementation-language-agnostic specifications from code, tests, docs, and configs.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill specops-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: specops-analysis
Source: https://github.com/ryan-mahoney/ryan-llm-skills/tree/main/skills/specops-analysis
Command: npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill specops-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill extracts a detailed, implementation-language-agnostic specification from existing artifacts (code, tests, docs, configs) to guide migration, modernization, or architecture reviews.

Core Features & Use Cases

  • Specification extraction: Converts code, tests, docs, and configs into structured, language-agnostic requirements, rules, and decision logic.
  • Policy & rules discovery: Identifies explicit and implicit business and technical policies embedded in artifacts.
  • Use Case: When you need a complete, implementation-agnostic spec to guide refactors or migrations without vendor lock-in.

Quick Start

Describe the TARGET_SCOPE or provide context, and the Skill will generate a comprehensive SpecOps specification.

Frequently Asked Questions about specops-analysis

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

FAQPage Schema
How do I extract a language-agnostic specification from existing code and documentation?

To extract a language-agnostic specification from existing code, tests, and docs, you provide the target artifacts to generate a structured SpecOps specification. This captures rules, defaults, thresholds, and decision logic as testable artifacts without vendor lock-in.

What is the best way to prepare for a code migration without losing business rules?

Preparing for a code migration without losing business rules requires discovering implicit and explicit policies embedded in your artifacts. Specification extraction identifies these workflow constraints and decision logic, converting them into structured, versioned requirements to guide the refactor.

Does specification extraction work with configs and runbooks or just source code?

Specification extraction works with configs and runbooks alongside source code, tests, and documentation. It analyzes these varied artifacts to identify business and technical policies, delivering a comprehensive, implementation-agnostic specification for architecture reviews.

How do I document implicit business policies for an architecture review?

Documenting implicit business policies for an architecture review involves analyzing existing artifacts to discover embedded rules and thresholds. The extraction process converts these hidden constraints into structured, testable specification artifacts that capture the complete workflow logic.

Can I turn existing tests and configs into versioned specification artifacts?

You can turn existing tests and configs into versioned specification artifacts by running them through specification extraction. The process captures defaults, decision logic, and workflow constraints from these inputs, delivering structured, testable requirements suitable for modernization efforts.