Skip to content
Get packs

Guide · Agent skill

How to use the Wiki Ingest agent skill (wiki-ingest)

Updated · written with AI from the project's own documentation and checked against our catalogue data

Wiki Ingest is an agent skill for the Paperclip LLM Wiki plugin. It tells an AI agent how to take one captured document from the wiki's raw/ folder and file it as durable, interlinked wiki pages. This guide explains what the skill does, how to install it, how to trigger it, and what your setup needs before it will run.

Wiki Ingestpaperclipai/paperclip · MIT

Quick start

  1. 1Confirm requirements. Check that the Paperclip LLM Wiki plugin provides the five wiki tools and that your space contains AGENTS.md, wiki/index.md and wiki/log.md.
  2. 2Download the ZIP. Download the wiki-ingest ZIP from this page. It contains SKILL.md.
  3. 3Unzip into a skills folder. Unzip into ~/.claude/skills/ for personal use or into a project's .claude/skills/ folder for one project.
  4. 4Or upload in the Claude apps. Alternatively, upload the skill under Settings → Capabilities → Skills.
  5. 5Create or receive an ingest request. Raise an operation issue with operationType set to ingest, including the raw/ path, wikiId and spaceSlug, or ask for "ingest <slug>".
  6. 6Review the output. Check the new source page, the contradiction callouts, the index entries and the log entry.

What is an agent skill and what does wiki-ingest do?

An agent skill is a folder containing a SKILL.md file with instructions that an AI agent loads when a task matches the skill's description. This one, wiki-ingest, applies when an operation issue asks the agent to ingest a captured raw/ source into the LLM Wiki, or when a user says "ingest <slug>".

When it runs, the agent reads the source end to end, writes a summary page for it, and updates related entity, concept, and synthesis pages with cross-links and citations. It also refreshes the wiki index, flags claims that contradict existing pages instead of overwriting them, and appends a dated entry to the wiki log. The raw source file is treated as read-only.

  • Writes a source page at wiki/sources/<slug>.md, roughly 300 to 800 words.
  • Updates or creates pages in entities/, concepts/, and synthesis/.
  • Adds one-line summaries for new pages to wiki/index.md.
  • Appends an ingest entry to wiki/log.md using a fixed heading format.
  • Marks contradictions with a callout on the older page rather than overwriting it.

Check the requirements before you install

The skill depends on the Paperclip LLM Wiki plugin. The source says it needs tools named wiki_list_sources, wiki_read_source, wiki_search, wiki_read_page and wiki_write_page. Without them the skill cannot read or write the wiki.

The skill also needs an operation issue with operationType set to ingest, plus a wikiId, spaceSlug and space root. The wiki space must contain AGENTS.md, wiki/index.md and wiki/log.md. If the wikiId or spaceSlug is missing, the skill stops and asks for that config.

  • Paperclip LLM Wiki plugin with the five wiki tools listed above.
  • An operation issue with operationType ingest.
  • wikiId, spaceSlug and the space root.
  • A wiki space containing AGENTS.md, wiki/index.md and wiki/log.md.
  • The skill runs no scripts and uses no network access, according to the source.

Install the wiki-ingest skill

Download the ZIP for this skill from the page you are reading. Unzip it so that the wiki-ingest folder, containing SKILL.md, sits in one of the locations below. The source lists these two file-based options.

You can also upload the skill through the Claude apps. The source gives this path: Settings → Capabilities → Skills.

  • Personal install: unzip into ~/.claude/skills/.
  • Project install: unzip into the project's .claude/skills/ folder.
  • Claude apps: upload the skill under Settings → Capabilities → Skills.
~/.claude/skills/wiki-ingest/SKILL.md

How do you trigger the skill with a natural request?

The skill loads when a request matches its description. The two triggers the source names are an operation issue that asks for an ingest, and a user saying "ingest <slug>" where the slug identifies a captured source. Use the slug that matches the raw file you want filed.

If the operation came from a routine with no live user, the agent proceeds on its own. If a user is asking interactively, the agent summarises the three to five takeaways it plans to file and asks which to emphasise before writing.

  • "Ingest meeting-notes-2024-q3" (where the slug matches a file in raw/).
  • An operation issue assigned to the agent with operationType set to ingest and a raw/ path in the body.

What happens during an ingest run?

The skill follows a fixed workflow. First it reads the space's AGENTS.md for page conventions, wiki/index.md for existing pages, and the last roughly 20 entries of wiki/log.md so it does not re-ingest a source someone already filed. Then it reads the source fully with wiki_read_source.

It then writes the source page, updates downstream pages, adds cross-links where each claim cites the source, and refreshes the index and log. Before closing the operation issue, it checks that the source page exists with a sources: field pointing to the raw path, that the index and log are updated, and that no file under raw/ was modified.

  • Source page cites claims as (see [[wiki/sources/<slug>]]).
  • Contradictions get a callout like > ⚠ contradicted by [[wiki/sources/<slug>]] (YYYY-MM-DD) on the older page.
  • The log entry heading format is preserved so grep "^## \[" wiki/log.md keeps working.
## [YYYY-MM-DD] ingest | <source title> - source: raw/<filename> - new pages: [[...]], [[...]] - updated pages: [[...]], [[...]] - notes: <one-line synthesis or open question>

Safety notes: scripts, network and raw files

According to the source, wiki-ingest runs no scripts and uses no network. Its work happens through the Paperclip wiki tools. Because it writes persistent wiki pages, review the changes it makes in your space, especially the contradiction callouts and the log entries.

The skill treats raw/ as immutable. It is designed to record what the source says and to check it only against existing wiki pages. It does not independently verify the source's facts, so a reviewer should still judge whether the source itself is reliable.

  • No scripts are run by this skill.
  • No network access is used by this skill.
  • Files under raw/ are not supposed to be modified.
  • Contradictions are annotated, not silently overwritten.

Tips for better ingests

Keep AGENTS.md current. The skill follows the page conventions in that file for filenames, frontmatter, voice and citation style, so a clear AGENTS.md produces more consistent pages.

Give each source one clear slug and keep the raw file in raw/. The skill looks for a raw/ path in the issue body, so an accurate path makes the run more reliable. For Paperclip bundles, the description points to a separate skill, paperclip-distill.

  • Keep wiki/index.md and wiki/log.md present; the skill needs both.
  • Ingest one source at a time so each log entry stays focused.
  • Use the interactive confirmation step when you want control over what gets emphasised.

What people use it for

  • Filing a captured meeting transcript as a source page with linked entity pages for the people and projects it names.
  • Updating a concept page with new evidence while flagging an older claim that the new source contradicts.
  • Building a consistent, cited knowledge base for a team that shares a Paperclip LLM Wiki space.
  • Testing ingest workflows during development of an LLM Wiki plugin setup.

Frequently asked questions

Is the wiki-ingest skill free to use?

The source for this skill is published under the MIT licence. The source does not describe any pricing, so check the Paperclip project for any terms about the plugin itself.

How do I install the wiki-ingest agent skill?

Download the ZIP from this page and unzip it so the wiki-ingest folder with SKILL.md sits in ~/.claude/skills/ or a project's .claude/skills/ folder. You can also upload it under Settings → Capabilities → Skills in the Claude apps.

What does the wiki-ingest skill require?

It requires the Paperclip LLM Wiki plugin with the wiki_list_sources, wiki_read_source, wiki_search, wiki_read_page and wiki_write_page tools. You also need an operation issue with operationType ingest, a wikiId, spaceSlug and space root, and a space containing AGENTS.md, wiki/index.md and wiki/log.md.

Does wiki-ingest run scripts or use the network?

According to the source, it runs no scripts and uses no network. It works through the wiki tools provided by the plugin.

Can I use wiki-ingest to summarise a document in chat?

This skill is not designed for quick chat summaries. It writes persistent wiki pages inside the Paperclip wiki structure, so a simple summary request is better handled by an agent without this skill.

What should I do if the skill stops and asks for config?

The skill stops when the wikiId, spaceSlug or space root is missing. Add those values to the operation issue, and make sure the wiki space contains AGENTS.md, wiki/index.md and wiki/log.md.

How does wiki-ingest compare with other ways of summarising sources?

The source describes wiki-ingest as writing linked, cited pages, flagging contradictions and logging each change. It records what the source says and checks it only against existing wiki pages, so it does not independently verify facts.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Wiki-ingest suits teams and maintainers who run a Paperclip LLM Wiki and want captured documents turned into consistent, linked and cited pages. It is a poor fit if you only want a quick chat summary, if you do not have the LLM Wiki plugin and its tools, or if you expect the agent to verify a source's facts on its own.

Download the skill