MCPInstall

writing-fragments

Writing, explore:挖掘原始 fragments,暂不施加任何结构。

Installs
3.6K
Last 24h
+17
Trending rank
#6410
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/vinvcn/mattpocock-skills-zh-cn --skill writing-fragments
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads writing-fragments automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

<what-to-do>

这是纯粹的 explore:在不承诺任何结构的前提下,拓宽可写内容的空间——承诺结构是 exploit,是另一个 skill 的工作。运行一个产出 fragments 的 grilling session,围绕用户想写的任何主题持续访谈。在这里强加 phases、outlines 或文章结构都不在范围内。

当对话双方产生 fragments 时,把它们追加到单一 markdown 文件。

如果用户没有传入路径,只询问一次文档保存到哪里,然后在 session 剩余部分记住它。

从用户说的第一句话开始捕获 fragments,包括 initial prompt。

第一次写入时,在顶部放一个带 working title 的单一 H1(之后可以改),除此之外什么都不要放:不要 metadata、TOC 或 date。

</what-to-do> <supporting-info>

What is a fragment

Fragment 是任何可能进入最终文章的文本片段。它必须_对作者可读_,也就是作者能知道它是什么意思;但它不需要定义术语,也不需要让冷读者立即理解。标准是 “这是不是一段好写作素材?”,不是 “这是不是自洽论证?”

Fragments 刻意保持异质。可能成为 fragment 的例子:

  • 一句 sharp sentence,你想在某处使用但还不知道放哪里。
  • 一个 claim 和一句 justification。
  • 一个 vignette:发生过的事、code snippet、scenario、analogy。
  • 一个 half-thought:"something about how X feels like Y, work this out later."
  • 一句 quote、一段 dialogue、一句 overheard line。
  • 一组凭感觉属于同一簇的 observations。
  • 一个 complaint、confession 或 punchline。
  • 一个 leading word——一个紧凑的隐喻或新造词,整篇文章都可以挂在它上面(一个为这个 idea 命名的术语,就像 tracer bullets 或 fog of war 为整个模式命名那样)。

在这些当中,leading word 是最值得落地的 fragment。它是 load-bearing 的:在 explore 阶段命名对的那一个,就会塑造之后的结构、transitions 和标题——在整个 exploit 阶段持续产生回报。当对话围绕一个反复出现的 idea 打转时,推动为它造一个词。

Novelist's diary 是模型:多年无结构的 noticings,之后被挖掘成 raw material。Fragments 就是 noticings。

File format

# Working title

A first fragment lives here.

It can be multiple paragraphs. It can include lists, code, quotes — whatever
shape the fragment naturally takes.

---

A second fragment.

---

> A quoted line that the user wants to keep around.

A reaction to it.

---

- A cluster of related observations
- That hang together by feel
- And want to be near each other

Fragments 用 horizontal rule(\n---\n)分隔。正文内不要 headings。不要 tags。除了加入顺序之外,不做排序。

Writing rhythm

安静追加。不要为每个 fragment 请求许可。可以顺带说你添加了什么("adding that"),但不要用 save dialogs 打断对话。

每次写入前:从磁盘重新读取文件。用户可能在回合之间编辑、重排或删除 fragments;保留他们的变化。永远不要 overwrite 文件;只 append(或者在用户要求时,就地编辑特定 fragment)。

用户随时可以说 "cut the last one"、"rewrite that one sharper"、"merge those two"。把它们当成一等指令。

</supporting-info>

FAQ

What does the writing-fragments skill do?

Writing, explore:挖掘原始 fragments,暂不施加任何结构。

How do I install writing-fragments?

Run npx skills add https://github.com/vinvcn/mattpocock-skills-zh-cn --skill writing-fragments in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/writing-fragments/ (personal) or .claude/skills/writing-fragments/ (project).

Which AI agents can use writing-fragments?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is writing-fragments safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains writing-fragments?

It is published by vinvcn in vinvcn/mattpocock-skills-zh-cn. It has 3,594 recorded installs.

More from vinvcn/mattpocock-skills-zh-cn

View all →

grill-me

vinvcn/mattpocock-skills-zh-cn

一个用来打磨计划或设计的持续追问式访谈。

6.7K installs

grill-with-docs

vinvcn/mattpocock-skills-zh-cn

一个用来打磨计划或设计的持续追问式访谈,并在过程中创建文档(ADRs 和词汇表)。

Docs & Writing6.3K installs

setup-matt-pocock-skills

vinvcn/mattpocock-skills-zh-cn

为此仓库配置 engineering skills:设置其 issue tracker、triage labels 词汇与 domain docs 布局。在首次使用其他 engineering skills 前运行一次。

Docs & Writing6K installs

tdd

vinvcn/mattpocock-skills-zh-cn

测试驱动开发。适用于用户想用先写测试的方式构建功能或修复缺陷、提到 “red-green-refactor”,或需要集成测试时。

Testing & QA5.9K installs

handoff

vinvcn/mattpocock-skills-zh-cn

把当前对话压缩成交接文档,让另一个代理接手。

improve-codebase-architecture

vinvcn/mattpocock-skills-zh-cn

扫描代码库中的深化机会,生成可视化 HTML 报告,然后围绕你选中的候选项继续追问。

Popular docs & writing skills

View category →

grill-with-docs

mattpocock/skills

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs