scraps

The Wiki-link doc compiler for the LLM era.

Generate Convert Improve

Install / Use

claude mcp add boykush -- npx -y github:boykush/scraps

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill

🔌

MCP Server

Model Context Protocol server

Quality Score

74/100

Our assessment of scraps

scraps scores 74/100 on our quality scale, 862nd of 965 AI & Machine Learning skills we index.

Its MCP Server is 3.5 KB long, well organised into 10 sections with 2 code examples: a solid amount of guidance for an agent.

It has 45 GitHub stars, so there is little community track record yet; judge it on its content.

Substance

26/30

Structure

18/20

Description

8/15

Adoption

7/20

Freshness

15/15

Maintenance, license and trust

The repository was last updated yesterday, so scraps is actively maintained.
Our last check on 2026-09-28 found the source still online.
It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-24. Automated pattern scan on 2026-09-24. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

scraps compared with similar skills

All 4 of these similar skills score higher than scraps; compare them before choosing.

Skill	Score	Stars	Updated	Format
scraps (this skill)by boykush	74	45	1d ago	MCP Server
claude-memby thedotmack	100	113.5k	today	CLAUDE.md
Agent-Reachby Panniantong	100	109.2k	today	CLAUDE.md
Understand-Anythingby Egonex-AI	100	90.9k	10d ago	CLAUDE.md
headroomby headroomlabs-ai	100	78.9k	today	CLAUDE.md

Frequently asked questions

How do I install scraps?: Run claude mcp add boykush -- npx -y github:boykush/scraps. The install tabs above show the steps for each supported agent.
Which AI agents does scraps work with?: It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is scraps safe to use?: Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is scraps still maintained?: The repository was last updated yesterday, so scraps is actively maintained.

Skill content

View source on GitHub

<h1 align="center"> <br> <img src="https://github.com/boykush/scraps/blob/main/assets/logo_opacity.png?raw=true" alt="scraps logo" width="200"> <br> Scraps <br> </h1> <p align="center"> <strong>The Wiki-link doc compiler for the LLM era.</strong> </p> <p align="center"> <a href="https://boykush.github.io/scraps/"><img alt="Documentation" src="https://img.shields.io/badge/docs-latest-blue?style=flat-square"></a> <a href="https://crates.io/crates/scraps"><img alt="Crates.io" src="https://img.shields.io/crates/v/scraps?style=flat-square"></a> <a href="https://github.com/boykush/scraps/blob/main/LICENSE.md"><img alt="License" src="https://img.shields.io/badge/license-MIT-blue?style=flat-square"></a> <a href="https://github.com/boykush/scraps/actions/workflows/cargo-test-and-lint.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/boykush/scraps/cargo-test-and-lint.yml?branch=main&style=flat-square"></a> </p>

Scraps treats documentation like a programming language. Wiki-linked markdown becomes a typed source, compiling into a static site for readers and into JSON any agent can shell into — turning Karpathy's LLM Wiki pattern into a typed, queryable artifact. CLI primary with companion AI skills, fitting any editor and any LLM agent.

Quick start

# Install
brew install boykush/tap/scraps    # or: cargo install scraps

# Compile a wiki
mkdir my-wiki && cd my-wiki
scraps init
scraps build

# Query the same source from a shell or AI agent
scraps search "release checklist" --json
scraps links "Configuration" --json
scraps lint

See the Getting Started tutorial for the full flow.

How it works

graph LR
  Source[Markdown sources] --> IR[Scraps IR — typed graph]
  IR --> HTML[Static HTML]
  IR --> JSON[CLI JSON]

Scraps reads [[wiki-link]], #[[tag]], ![[embed]], [[Page#heading]], and ctx_path as typed primitives. The same source compiles to an HTML site for human readers and to JSON for scripts and AI agents.

AI integration

CLI + JSON is the primary path — any shell-capable agent can query Scraps without an MCP client implementation. Bundled plugins provide agent-facing workflows:

scraps — Karpathy-style Ingest / Query / Lint skills for Claude Code and Codex, plus Claude Code agents for purpose-driven lint and the default Scraps LLM Wiki schema
mcp-server — MCP server for MCP-compatible clients, shared across repositories via scraps mcp serve --http

See the AI integration guide for the trade-offs.

Documentation

Documentation site — Tutorial, How-to, Reference, Explanation
Sample wiki — Japanese knowledge base built with Scraps

Screenshots

Search, pagination, and Wiki-link navigation, themed with Nord.

<details> <summary>Light mode</summary> <img src="https://github.com/boykush/scraps/blob/main/assets/light_mode.png?raw=true" alt="static site light mode" width="800"> </details>

Contributing

Bugs, feature requests, and PRs are welcome. See CONTRIBUTING.md, the issue templates, and the Code of Conduct.

License

MIT

Related Skills

claude-mem

113.5k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

Agent-Reach

109.2k

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

Understand-Anything

90.9k

Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.

headroom

78.9k

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

boykush

View profile

View on GitHub

GitHub Stars45

CategoryAI

Updated1d ago

Forks6

boykush/scraps

Languages

Rust

Trust signals

92/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low1 info