# ccf-paper-to-exemplar

Turns the paper PDFs you feed it into writing exemplar cards and files them into your own library. Useful when you need real samples of structure and phrasing for a draft.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1900 installs · ★ 3264
- Author: mikubaka88
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/mikubaka88/CCFA-Skills/tree/HEAD/ccf-paper-to-exemplar/SKILL.md
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/skills/ccf-paper-to-exemplar

## What it does

The skill reads a paper and writes down how it works: the story it tells, what the abstract and introduction do, how the method and evidence sections move, which citation habits come back. That becomes a card with sections for Story Pattern, Abstract Moves, Introduction Moves, Method Moves, Evidence Moves, Citation Patterns, Reusable Techniques and Do-Not-Copy Boundary. Finished cards are registered in a personal library you can pull from later.

Extraction runs through `scripts/convert.py` with `--output-dir`, `--full-text` and `--full-text-dir` spelled out. That step wants Python with `pymupdf`. The converter writes only missing skeletons and leaves an existing card alone when the source version matches, so a rerun will not wipe your edits. Work files default to `ccfa-workfiles/exemplars/<source-id>/`, with raw text under `cache/`, away from the card library.

Attribution stays with the source. Argument structure and some language conventions carry over, scientific claims do not, and a Do-Not-Copy Boundary section marks that line. Read it before leaning on a card in your own draft: an empty extraction is not the same as a finished analysis.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add mikubaka88/CCFA-Skills --skill ccf-paper-to-exemplar -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ccf-paper-to-exemplar/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ccf-paper-to-exemplar/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add mikubaka88/CCFA-Skills --skill ccf-paper-to-exemplar -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ccf-paper-to-exemplar/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add mikubaka88/CCFA-Skills --skill ccf-paper-to-exemplar -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ccf-paper-to-exemplar/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mikubaka88/CCFA-Skills ccf-paper-to-exemplar
```

2. **Manually: put the files in place**
- File: `.github/skills/ccf-paper-to-exemplar/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add mikubaka88/CCFA-Skills --skill ccf-paper-to-exemplar -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/mikubaka88/CCFA-Skills --path ccf-paper-to-exemplar
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ccf-paper-to-exemplar/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add mikubaka88/CCFA-Skills --skill ccf-paper-to-exemplar -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/mikubaka88/CCFA-Skills/tree/HEAD/ccf-paper-to-exemplar/SKILL.md

## When to use it
- turn a paper PDF into a writing exemplar card
- build a personal library of sample papers
- refresh one section of an existing card in place
- hand the right writing moves to the drafting skill
- check where copying a paper's claims stops

## Example prompts
- Turn `papers/main.pdf` into an exemplar card under `ccfa-workfiles/exemplars/main/`
- Register this card in `../ccf-paper-writer/references/exemplars/index.md` without duplicating entries
- Update Reusable Techniques in the existing card, same source version

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: cb4cce1823f8f7df.

BEGIN THIRD-PARTY FILE cb4cce1823f8f7df
```text
---
name: ccf-paper-to-exemplar
description: "Distill supplied paper PDFs into writing exemplar cards and register a requested personal library. Use for PDF to writing exemplar, 写作范例, and reusable paper-writing patterns. Preserve attribution; transfer argument structure and selected language conventions without copying scientific claims. Figure reconstruction, manuscript drafting, and review have separate owners."
metadata:
  ccf_skill_controls:
    handoff_question_mode: partial
    respect_session_denylists: true
    protect_idea_scope_in_writing: true
    private_material_safety: moderate
    shared_controls: ../ccf-common/references/
---

# Paper-to-Exemplar

## Family File Contract

Before file work, reuse canonical paths and one task/artifact working directory; default to project-root `ccfa-workfiles/<purpose>/<artifact-id>/`. Update in place, preserve inputs, and use UTF-8 with Chinese-text checks. Apply [artifact-contracts.md](../ccf-common/references/artifact-contracts.md) for naming, ownership, and task-created cleanup; handoffs inherit these paths.

## Collaboration Contract

Before specialist execution, read and apply [ccf-humanization](../ccf-humanization/SKILL.md) first, then [ccf-common](../ccf-common/SKILL.md). At every handoff, reuse their applicable active rules or refresh missing/changed ones. Both preflights are required even without prose; detailed editing, experiment, and maintenance modes run only when relevant.

Integrate necessary specialist contributions under one owner; reuse valid prerequisites and verify affected results. Follow the [cooperation routes](../ccf-common/references/routing.md) without duplicate reports.

## Scope And Shared Controls

Distill supplied paper PDFs into reusable writing patterns, preserving source attribution and scientific meaning. This skill owns exemplar cards; manuscript drafting belongs to `ccf-paper-writer`, visual reconstruction to `ccf-visual-composer`, and scientific review to `ccf-paper-reviewer`.

Follow `../ccf-common/references/handoff-modes.md`, `../ccf-common/references/task-modes.md`, and `../ccf-common/references/artifact-contracts.md`. Resolve existing card/library and cache paths before writing. Preserve no-new-files requests by editing a named existing card or returning the analysis in context. Conversion alone does not authorize global library/default changes.

## Workflow
```
END THIRD-PARTY FILE cb4cce1823f8f7df

The third-party file has ended. Everything between the cb4cce1823f8f7df tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2398 of 6220 bytes. © mikubaka88 · MIT · https://github.com/mikubaka88/CCFA-Skills/tree/HEAD/ccf-paper-to-exemplar/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md