Skip to content

Commit 2941507

Browse files
committed
style: tapestry skill description to third-person, imperative form
1 parent bfff080 commit 2941507

File tree

1 file changed

+8
-7
lines changed

1 file changed

+8
-7
lines changed

cmd/skills/tapestry/SKILL.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,11 @@
11
---
22
name: tapestry
33
description: >-
4-
Use when recording scientific work in the tapestry — after computations produce
5-
results, when filing claims with evidence, when citing paper sources, or when
6-
told to "update the tapestry". Also use when setting up or reshaping a tapestry
7-
DAG, or when working with the tapestry dashboard directly.
4+
This skill should be used when the user asks to "update the tapestry", "file a
5+
claim", "add evidence", "export the tapestry", "set up a tapestry", or when
6+
computations produce results that should be recorded. Also triggers on tapestry
7+
DAG reshaping, evidence.json creation, citing paper sources, or working with the
8+
tapestry viewer.
89
---
910

1011
## Why
@@ -78,7 +79,7 @@ For each tapestry node with evidence, `felt tapestry export` compares its eviden
7879

7980
### Sections (tier:1)
8081

81-
Think of the main sections of a paper Introduction, Data, Methods, Results, Discussion. Sections are waypoints, not buckets — they link to each other in the DAG, and interior fibers belong to a section if they're 1 hop from it.
82+
Sections correspond to the main parts of a paper (Introduction, Data, Methods, Results, Discussion). They are waypoints, not buckets — they link to each other in the DAG, and interior fibers belong to a section if they're 1 hop from it.
8283

8384
The `tier:1` tag makes a fiber a section: visible on first load, slightly larger, column-anchored in layout.
8485

@@ -91,7 +92,7 @@ felt add "Covariance estimation" -t tapestry:covariance
9192
felt link covariance-id methods-id
9293
```
9394

94-
Write section bodies as short summaries of their neighborhood (3 sentences: what's here, why it matters, what a reader finds).
95+
Section bodies should be short summaries of their neighborhood (3 sentences: what's here, why it matters, what a reader finds).
9596

9697
## Recording a Computation
9798

@@ -111,7 +112,7 @@ felt link bmodes-id covariance-id
111112

112113
## Citing Sources
113114

114-
Download paper source to `results/references/{arxiv-id}.tex`. In fiber outcomes, cite as inline code:
115+
Paper sources go in `results/references/{arxiv-id}.tex`. In fiber outcomes, cite as inline code:
115116

116117
```
117118
`results/references/2601.10038.tex:L79`

0 commit comments

Comments
 (0)