Agent skill

Reverse Document

Generate design docs, ADRs, and concept docs from existing code by reverse engineering intent

MITAuto-check passedDevelopment

Install Reverse Document

skills CLI

$ npx skills add vibeeval/vibecosystem --skill reverse-document -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install vibeeval/vibecosystem reverse-document --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/vibeeval/vibecosystem.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/reverse-document .claude/skills/reverse-document && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "reverse-document" agent skill from https://github.com/vibeeval/vibecosystem/tree/main/skills/reverse-document into .claude/skills/reverse-document/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reverse-document", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/vibeeval/vibecosystem/tree/main/skills/reverse-document

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add vibeeval/vibecosystem --skill reverse-document -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install vibeeval/vibecosystem reverse-document --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vibeeval/vibecosystem.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/reverse-document .agents/skills/reverse-document && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "reverse-document" agent skill from https://github.com/vibeeval/vibecosystem/tree/main/skills/reverse-document into .agents/skills/reverse-document/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reverse-document", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add vibeeval/vibecosystem --skill reverse-document -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install vibeeval/vibecosystem reverse-document --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vibeeval/vibecosystem.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/reverse-document .cursor/skills/reverse-document && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "reverse-document" agent skill from https://github.com/vibeeval/vibecosystem/tree/main/skills/reverse-document into .cursor/skills/reverse-document/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reverse-document", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/vibeeval/vibecosystem.git --path skills/reverse-document

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add vibeeval/vibecosystem --skill reverse-document -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install vibeeval/vibecosystem reverse-document --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vibeeval/vibecosystem.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/reverse-document .gemini/skills/reverse-document && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "reverse-document" agent skill from https://github.com/vibeeval/vibecosystem/tree/main/skills/reverse-document into .gemini/skills/reverse-document/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reverse-document", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install vibeeval/vibecosystem reverse-document

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add vibeeval/vibecosystem --skill reverse-document -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/vibeeval/vibecosystem.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/reverse-document .github/skills/reverse-document && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "reverse-document" agent skill from https://github.com/vibeeval/vibecosystem/tree/main/skills/reverse-document into .github/skills/reverse-document/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reverse-document", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add vibeeval/vibecosystem --skill reverse-document -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install vibeeval/vibecosystem reverse-document --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vibeeval/vibecosystem.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/reverse-document .opencode/skills/reverse-document && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "reverse-document" agent skill from https://github.com/vibeeval/vibecosystem/tree/main/skills/reverse-document into .opencode/skills/reverse-document/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reverse-document", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: reverse-document
GitHub stars: 531
Token cost: ~779 tokens
SKILL.md length: 217 words
Files: 1
Skills in repo: 144
Repo updated: Aug 8, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Generate design docs, ADRs, and concept docs from existing code by reverse engineering intent

Works in 3 steps: Design Mode (Koddan GDD/PRD) → Architecture Mode (Koddan ADR) → Concept Mode (Prototypeden Concept Doc)
Tasks that involve Architecture decision records
SKILL.md covers 3 Mod, Intent Sorulari, Workflow and Kurallar
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Reverse Document is an agent skill from vibeeval/vibecosystem. Generate design docs, ADRs, and concept docs from existing code by reverse engineering intent

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Architecture decision records and Reverse engineering and malware. The repository describes itself as: AI software team for Claude Code - 138 agents, 295 skills, 73 hooks. Self-learning, multi-agent swarm, autonomous skill evolution. The licence is MIT.

When your agent uses it

Tasks that involve Architecture decision records
Tasks that involve Reverse engineering and malware

Example prompts

“/reverse-document”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

Design Mode (Koddan GDD/PRD)
Architecture Mode (Koddan ADR)
Concept Mode (Prototypeden Concept Doc)

What it can do on your machine

Read from SKILL.md and the folder at commit 3b763b1. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reverse Document loads about 779 tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 217 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~28
When it runs · the whole SKILL.md, loaded when a task matches: ~779

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vibeeval/vibecosystem at commit 3b763b1, republished under its MIT licence (© vibeeval). 217 words, ~779 tokens.

Download SKILL.mdSave it as .claude/skills/reverse-document/SKILL.md (or your agent's skills folder).

name: reverse-document
description: Generate design docs, ADRs, and concept docs from existing code by reverse engineering intent

Reverse Document

Koddan dokuman uret. "Bu sistem neden var?" sorusunu cevapla.

3 Mod

1. Design Mode (Koddan GDD/PRD)

Mevcut kodu analiz ederek tasarim dokumani uret.

Input: Kaynak kod dizini veya dosya Output: Product/Feature Design Document

Sablonlu cikti:

markdown

# [Feature/System Adi]

## Problem Statement
Bu sistem hangi problemi cozuyor?

## Solution Overview
Nasil cozuyor? (High-level mimari)

## Key Decisions
Neden bu yaklasim secildi? (Koddan cikarim)

## Components
- [Component 1]: Gorevi, bagimliliklari
- [Component 2]: Gorevi, bagimliliklari

## Data Flow
1. [Adim 1]
2. [Adim 2]

## Edge Cases & Error Handling
Kodda gorulmus ozel durumlar

## Limitations
Bilinen sinirlamalar (TODO/FIXME/HACK yorumlarindan)

2. Architecture Mode (Koddan ADR)

Mimari kararlari reverse engineer ederek ADR (Architecture Decision Record) uret.

Input: Kaynak kod, config dosyalari, dependency listesi Output: ADR dokumenti

Sablonlu cikti:

markdown

# ADR-[N]: [Karar Basligi]

## Status
Accepted (kodda uygulanmis)

## Context
Bu karar hangi kosullarda alinmis? (Koddan cikarim)

## Decision
Ne yapilmis? (Concrete implementation)

## Rationale
Neden? (Dependency secimleri, pattern kullanimi, config'den cikarim)

## Alternatives Considered
Kullanilmayan alternatifler (varsa yorum/TODO'lardan)

## Consequences
- Pozitif: [...]
- Negatif: [...]
- Riskler: [...]

3. Concept Mode (Prototypeden Concept Doc)

Erken asamadaki koddan konsept dokumani uret.

Input: Prototip/POC kodu Output: Concept Document

Sablonlu cikti:

markdown

# [Konsept Adi]

## One-Liner
Tek cumlelik aciklama

## Problem
Hangi problemi cozuyor?

## Proposed Solution
Prototipte denenmis yaklasim

## Key Insights
Prototipten ogrenilenler

## Open Questions
Henuz cevaplanmamis sorular

## Next Steps
Production'a tasimak icin gerekli adimlar

Intent Sorulari

Kodu okumadan ONCE su sorulari sor (veya koddan cikar):

Neden var? Bu sistem/modul/fonksiyon hangi problemi cozuyor?
Kim kullaniyor? Hedef kullanici/consumer kim?
Alternatifler? Baska yaklasimlar dusunulmus mu? (Yorumlar, git history)
Sinirlamalar? Bilinen kisitlamalar ne? (TODO, FIXME, HACK)
Evrim? Zaman icinde nasil degismis? (git log --oneline)

Workflow

Scan: Dosya yapisini, dependency'leri, config'leri tara
Read: Ana dosyalari oku, entry point'ten basla
Trace: Data flow'u takip et (input -> process -> output)
Extract: Pattern'leri, kararlari, edge case'leri cikar
Question: Intent sorularini cevapla (koddan veya kullanicidan)
Write: Secilen mod sablonuna gore dokumani yaz
Review: Kullaniciyla birlikte dogrula

Kurallar

Spekuasyon yapma, kodda gordugun seyi yaz
"Muhtemelen" yerine "Kodda goruldugu uzere" kullan
Git history varsa kararlarin kronolojisini ekle
TODO/FIXME/HACK yorumlarini "Limitations" bolumune ekle
Kodda olmayan seyi dokumante etme

Files

Just SKILL.md in skills/reverse-document of vibeeval/vibecosystem.

Open the folder on GitHubat commit 3b763b1

Compare with similar skills

Reverse Document next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Reverse Document compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Reverse Document this skillvibeeval/vibecosystem	531	—	~779	Automated safety check: Pass	MIT	2 mo ago
Architect Inittikalk/adlc-team-skills	141	—	~7.4k	Automated safety check: Pass	MIT	yesterday
TH08 Library RecoveryN0zoM1z0/th08	100	—	~877	Automated safety check: Pass	MIT	18 days ago
Pci Secure Softwaretransilienceai/communitytools	559	—	~1.8k	Automated safety check: Pass	MIT	2 mo ago
D365 Solution Blueprintgithub/awesome-copilot	40k	—	~2.7k	Automated safety check: Pass	MIT	today
Icsme Topic Selectionbrycewang-stanford/Awesome-Journal-Skills	1.2k	—	~1.7k	Automated safety check: Pass	MIT	10 days ago

Similar skills

Architect Init
tikalk/adlc-team-skills
A skill your agent uses when bootstrapping architecture documentation for a brownfield project by reverse-engineering ADRs from an existing codebase.
141 GitHub stars~7.4k tokensUpdated yesterday
DevelopmentAuto-check passed
TH08 Library Recovery
N0zoM1z0/th08
Covers recovering and verifying the VC7 C runtime, compiler-runtime and D3DX library functions in the TH08 decompilation, with hash-pinned evidence.
100 GitHub stars~877 tokensUpdated 18 days ago
DevelopmentAuto-check passed
Pci Secure Software
transilienceai/communitytools
Automated PCI Secure Software Standard (SSS) v2.0 readiness gap-assessment of an application from its source code and documentation.
559 GitHub stars~1.8k tokensUpdated 2 mo ago
DevelopmentAuto-check passed
D365 Solution Blueprint
github/awesome-copilot
Official
Authors a Dynamics 365 Finance and Supply Chain Management Solution Blueprint from scratch through a structured, section-by-section architect interview, establishing scope, target operating model…
40k GitHub stars~2.7k tokensUpdated today
DevelopmentAuto-check passed
Icsme Topic Selection
brycewang-stanford/Awesome-Journal-Skills
A skill your agent uses when deciding whether a software-engineering project belongs at IEEE ICSME (maintenance, evolution, reverse engineering, program comprehension, technical debt, refactoring…
1.2k GitHub stars~1.7k tokensUpdated 10 days ago
DevelopmentAuto-check passed
PR Design Doc
OpenHands/OpenHands
For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…
90k GitHub stars~2.4k tokensUpdated today
DevelopmentAuto-check passed

Questions about Reverse Document

What does Reverse Document do?

Generate design docs, ADRs, and concept docs from existing code by reverse engineering intent. Reverse Document is an agent skill from vibeeval/vibecosystem.

When should I use Reverse Document?

Reverse Document fits situations like: tasks that involve Architecture decision records; tasks that involve Reverse engineering and malware.

How do I install Reverse Document in Claude Code?

Run `npx skills add vibeeval/vibecosystem --skill reverse-document -a claude-code`. Or copy the skill folder (skills/reverse-document in vibeeval/vibecosystem) into .claude/skills/reverse-document in your project. Claude Code loads it when a task matches its description.

How do I install Reverse Document in Codex?

Run `npx skills add vibeeval/vibecosystem --skill reverse-document -a codex`. Or copy the skill folder (skills/reverse-document in vibeeval/vibecosystem) into .agents/skills/reverse-document in your project. Codex loads it when a task matches its description.

Can I use Reverse Document in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vibeeval/vibecosystem --skill reverse-document -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reverse-document, .gemini/skills/reverse-document, .github/skills/reverse-document and .opencode/skills/reverse-document in your project.

What does Reverse Document need to run?

SKILL.md names no scripts, command-line tools or credentials: Reverse Document is instructions for the agent only.

Does Reverse Document access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Reverse Document safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Reverse Document use?

Reverse Document is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Reverse Document use?

About 779 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Reverse Document?

Skills that share tags, products or a category with Reverse Document: Architect Init (tikalk/adlc-team-skills, 141 stars), TH08 Library Recovery (N0zoM1z0/th08, 100 stars), Pci Secure Software (transilienceai/communitytools, 559 stars) and D365 Solution Blueprint (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reverse Document?

vibeeval (a GitHub user) maintains it in vibeeval/vibecosystem, which has 531 GitHub stars. The repository holds 144 skills in this directory. The repository was last updated on August 8, 2026.

Source: vibeeval/vibecosystem on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Reverse Document

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Reverse Document

3 Mod

1. Design Mode (Koddan GDD/PRD)

2. Architecture Mode (Koddan ADR)

3. Concept Mode (Prototypeden Concept Doc)

Intent Sorulari

Workflow

Kurallar

Files

Compare with similar skills

Similar skills

More from vibeeval/vibecosystem

Related

Questions about Reverse Document