skillZs
LIVE SKILL TAGS
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
REAL INSTALL DATA
← back to all skills
vinvcn/mattpocock-skills-zh-cn2.6k installs

writing-fragments

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

How do I install this agent skill?

npx skills add https://github.com/vinvcn/mattpocock-skills-zh-cn --skill writing-fragments
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is a productivity tool for collecting writing fragments into a local file. It is generally safe but possesses a surface for indirect prompt injection because it reads back the file contents to preserve user edits, which could contain malicious instructions that influence the agent's behavior in subsequent turns.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

<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 bulletsfog 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>

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/vinvcn/mattpocock-skills-zh-cn/writing-fragments">View writing-fragments on skillZs</a>