wrap-skill

KO | EN

gitlite — search

#javascript #python #hacktoberfest #llm #golang #machine-learning #rust #java #nodejs #vue #pytorch #security #mcp #open-source

(★ 64)

A Claude Code skill that consolidates scattered project markdown files into a single canonical CLAUDE.md, with a pinned PROGRESS block at the top.

wrap-skill Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# wrap

A **Claude Code plugin** (also installable manually in Codex / OpenCode / etc.) that consolidates every scattered descriptive markdown file in a project (`README.md`, `AGENTS.md`, `HANDOFF.md`, `docs/*`) into a single canonical `CLAUDE.md` and reconciles it against the current code.

After one run, the next session — yours, a teammate's, or a fresh agent's — has exactly one entry point.

## Why

Working with AI coding agents tends to produce documentation sprawl: a `HANDOFF.md` from one session, an `AGENTS.md` from another, a half-stale `README.md`, a `docs/` folder with three-week-old design notes. Each session's "context dump" creates a new file, and over time the project loses its single source of truth.

`wrap` does the opposite. Each invocation:

1. Reads every descriptive `.md` in the project
2. Scans the actual code (entry points, scripts, routes, configs)
3. Folds it all into one `CLAUDE.md` with a fixed structure
4. **Deletes the originals** so there's nothing to drift back out of sync
5. Pins a `PROGRESS` block at the top answering: *where are we now*, *what's the next concrete action*

## Install

This repo is a **Claude Code plugin marketplace**. From inside Claude Code:

```
/plugin marketplace add recomby-ai/wrap-skill
/plugin install wrap@wrap-skill
```

That's it — no git clone, no manual file copying. To update later, run `/plugin marketplace update wrap-skill`.

<details>
<summary>Manual install (other agents / no plugin support)</summary>

If you're using an agent that supports `SKILL.md` but not Claude Code's plugin system, copy the file manually:

```bash
mkdir -p ~/.claude/skills/wrap && curl -fsSL https://raw.githubusercontent.com/recomby-ai/wrap-skill/main/plugins/wrap/skills/wrap/SKILL.md -o ~/.claude/skills/wrap/SKILL.md
```

Adjust the destination path for Codex / OpenCode / Cursor / Gemini CLI as needed.
</details>

## Use

Just say one of these in any project:

- `wrap` / `wrap up` / `/wrap`
- `tidy docs` / `sync docs` / `update docs` / `archive`
- `this phase is done`
- Chinese: `收尾` / `同步文档` / `整理文档` / `整理一下` / `更新文档` / `存档` / `梳理一下` / `这阶段做完了`

The agent will:

- Inventory every `.md` and cross-check it against the real code
- Write a fresh `CLAUDE.md` with `PROGRESS / Architecture / Run / API / Known Limits / Handoff` sections
- Delete the merged-in source files
- Print a short change summary

## Output Format

`CLAUDE.md` follows a fixed skeleton:

```
# <project>

<one-line summary>

## PROGRESS
**Current**: ...
**Next**: ...
**Known outstanding**: ...

## Architecture
## Run
## API / Interfaces     (skipped if project has no external interfaces)
## Known Limits
## Handoff
```

Soft cap of 250 lines. If a project genuinely needs more (multi-service runbooks, large credential tables), the skill applies for a documented exemption rather than padding or hand-waving.

## Design Principles

- **One file**. Zero is too few; two is too many.
- **PROGRESS is the soul**. Other sections survive a stale week; PROGRESS dies in a day. Rewrite it every run.
- **Brevity beats completeness**. Decision history and design rationale go in the agent's memory system, not in `CLAUDE.md`.
- **Code is the source of truth**. When `CLAUDE.md` conflicts with the code, the code wins — always.

## Compatibility

Tested with Claude Code. Should work in any agent that supports the SKILL.md format (Codex, OpenCode, Cursor, Gemini CLI, etc.).

The skill only touches files inside the project directory. It does not interact with any agent's memory system — those are decoupled by design.

## License

MIT — see [LICENSE](./LICENSE).

wrap-skill

wrap-skill Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

wrap-skill

wrap-skill Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README