skills.rest
GeoloeG-IsT
GeoloeG-IsTCOMMUNITY
Explore all skills by this author →
GitHub

are-specify

Read AGENTS.md files to generate a versioned project specification.

19|4|Updated Jan 25, 2026
Search Tags:#automation#workflow#documentation#monitoring#specification#ai#agents.md
One-click install
npx skills add https://github.com/GeoloeG-IsT/agents-reverse-engineer --skill are-specify
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: are-specify
Source: https://github.com/GeoloeG-IsT/agents-reverse-engineer/tree/main/.claude/skills/are-specify
Command: npx skills add https://github.com/GeoloeG-IsT/agents-reverse-engineer --skill are-specify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert AGENTS.md documentation into a comprehensive project specification that can guide development, QA, and integration.

Core Features & Use Cases

  • Reads version from ARE-VERSION and uses it to version the generated spec.
  • Orchestrates the specify workflow in the background and reports progress in real time.
  • Auto-runs generate if no AGENTS.md files exist and summarizes results, including number of files collected and spec output.

Quick Start

Run the specify workflow to generate a project specification from AGENTS.md documents.

Frequently Asked Questions about are-specify

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

FAQPage Schema
How do I generate a project specification from AGENTS.md files?▼

To generate a project specification, the Skill collects AGENTS.md files across your repository, synthesizes them via AI, and writes a comprehensive SPEC file to guide development and QA.

What happens if I run the specify workflow but no AGENTS.md files exist?▼

If no AGENTS.md files exist in the repository, the specify workflow automatically runs the generate process and summarizes the results, including the number of files collected and the spec output.

Do I need ARE-VERSION to output a project specification?▼

Yes, ARE-VERSION is required to version the generated project specification output, ensuring the formal SPEC file is properly tracked and managed.

Can I preview the project specification before writing the final SPEC file?▼

Yes, you can use the --dry-run option to preview the specify workflow and review the synthesized project specification before the tool writes the final output to your repository.

How does the specify workflow handle multiple AGENTS.md documents across a repository?▼

The workflow collects multiple AGENTS.md files across the repository and synthesizes them via AI into a single comprehensive SPEC file, with the --multi-file option available to manage the output structure.

What are the limitations when converting AGENTS.md docs into a project spec?▼

The process relies on AI synthesis of existing AGENTS.md documentation, meaning output quality is bounded by the input files' detail and requires the ARE-VERSION dependency to properly version the final SPEC file.

Related Skills

Explore More Software Engineering Skills→
MatrixFounderMatrixFounder
4

skill-update-memory

Detect source file changes and generate `.AGENTS.md` documentation updates.

Community
Intermediate
unclehowellunclehowell

subagent-driven-development

Execute implementation plans by dispatching fresh subagents for each task.

Community
Advanced
cshyangcshyang

trigger-realtime

Subscribe to Trigger.dev task runs and streams for real-time UI updates.

Community
Advanced
redpanda-dataredpanda-data
34

writing-fragments

Extract writing fragments from conversations into a single markdown file.

Official
Basic