Updated today
by QiYueran-source
weave-your-work
Skills for AI agents that run team work as one target tree: maps refine into tasks, each node has one owner, and work closes against an acceptance signal written before it starts. Tickets live in the repo, so the plan and its record stay together.
50 GitHub stars (50)
+50 in 9 days
- 27 skills (27 skills found in its SKILL.md files)
- 0 forks (0 forks)
- Today last update (Last updated today)
Install
Skills CLI
npx skills add QiYueran-source/weave-your-work
Asks which skills and agents to install. Just one: npx skills add QiYueran-source/weave-your-work --skill adr — add -g for every project.
Claude Code
git clone https://github.com/QiYueran-source/weave-your-workcp -r "weave-your-work/weave-your-work/adr" ~/.claude/skills/
Copies the adr skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add QiYueran-source/weave-your-work
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
adr
Record a decision as an ADR when it is hard to reverse, surprising without context, and the result of a real trade-off: write the next numbered file, link it to its record, and supersede an older one without deleting it. Use when a discussion settles a decision that passes the three gates.
weave-your-work/adr/ on GitHub (opens in a new tab)SKILL.md -
advance-task
Advance one task to its end, or every ready task under a map as a batch, and stop only where something blocks it. Use when a person asks to work a task, to run a batch, or to continue what a previous run left in Progress.
weave-your-work/advance-task/ on GitHub (opens in a new tab)SKILL.md -
ask-me
Pick the skill that fits the situation in front of you: the mainline a project runs on, the auxiliary actions, the records, and the branch points. Use when a person does not know which skill to use now.
weave-your-work/ask-me/ on GitHub (opens in a new tab)SKILL.md -
feedback-me-please
Send a skill bug or a good experience upstream to QiYueran-source/weave-your-work: check for a duplicate, draft the issue, send only after the person approves, and star the repository when it is not already starred. Use when a skill behaved wrongly, a skill was better than expected, or the person asks to report something upstream.
weave-your-work/feedback-me-please/ on GitHub (opens in a new tab)SKILL.md -
fog-explore
Clear a map's Not yet specified: settle each open entry into a decision, a target update, an exclusion, or a hand-off to split, one entry at a time. Use when a map's next layer is blocked by an open entry.
weave-your-work/fog-explore/ on GitHub (opens in a new tab)SKILL.md -
glossary
Keep one vocabulary for the project: look a term up, sharpen a fuzzy word into a canonical one, and write it to your own source file so the generated view stays whole. Use when a term is fuzzy or overloaded, when a word conflicts with the glossary, or when a discussion settles a term.
weave-your-work/glossary/ on GitHub (opens in a new tab)SKILL.md -
grill-and-records
Settle a fuzzy plan, decision, or idea and write down what it settled: run the discussion, then write the terms into the glossary and the decisions into ADRs. It assembles; the discussion is `grilling`'s and each record is `adr`'s or `glossary`'s. Use when a decision needs a person, or when another skill reaches a question it cannot settle alone.
weave-your-work/grill-and-records/ on GitHub (opens in a new tab)SKILL.md -
grilling
Grill a plan, decision, or idea until it is clear: ask the questions that can be answered now, wait for the answers, and write each round into a testimony. It writes the testimony and nothing else: what the discussion settled is written by `adr` and `glossary`, run by `grill-and-records`. Use when a plan is still fuzzy, or when another skill reaches a decision it cannot settle alone.
weave-your-work/grilling/ on GitHub (opens in a new tab)SKILL.md -
handoff
Write a handoff document when the work continues in another session: cite the records instead of restating them, and say where the session stopped, what was dropped, and what comes next. Use when a session is ending, the context is nearly full, or the work moves to a fresh agent.
weave-your-work/handoff/ on GitHub (opens in a new tab)SKILL.md -
issue
Carry a communicate issue to a GitHub recipient and bring it back: write the frontmatter and the ask, receive it through the listener queue, land the decision that changes local work, and close it. Use when something has to reach another owner, or when the queue holds a message.
weave-your-work/issue/ on GitHub (opens in a new tab)SKILL.md -
map-review
Judge a map against the acceptance direction it was written with, give each axis its own verdict, record both with their evidence, and close the map or send it back. Use when every child of a map is closed, or when a map's verdict is questioned.
weave-your-work/map-review/ on GitHub (opens in a new tab)SKILL.md -
map
The reference for a map record: the six body sections, the fog forms, the three states, and the two review axes. Read it before writing, changing, or judging a map.
weave-your-work/map/ on GitHub (opens in a new tab)SKILL.md -
open-map
Write one map: turn the target it is given into a body with its fog and exclusions, and record where the target came from. The same action writes a root map and a child map. Use when a target is settled and has no map yet, or when a split is writing child maps.
weave-your-work/open-map/ on GitHub (opens in a new tab)SKILL.md -
open-task
Write one task record: choose delivery or probe, write the action and its acceptance signal, and set the kind, reversibility, and whether a person is needed. Use when a layer is being split into tasks, or when a task has to be written outside a split.
weave-your-work/open-task/ on GitHub (opens in a new tab)SKILL.md -
resplit
Recut a map that already split into tasks, when one task turns out to need another's output: gather the independent tasks under one child map and the waiting one under another, add the dependency edge between those maps, and re-hang the tasks. Use when a task cannot start because a sibling task has not finished.
weave-your-work/resplit/ on GitHub (opens in a new tab)SKILL.md -
salvage-and-restart
Restart a project whose tree no longer describes its work: write down what is still usable, raise a new root map, and clear then archive the old tree bottom-up, each retired record carrying a reason that names the salvage record. Use when a stop-and-wait report shows the tree itself is the problem, or the person asks to start over.
weave-your-work/salvage-and-restart/ on GitHub (opens in a new tab)SKILL.md -
setup
Configure a project so the set can run in it: confirm the project root, install git, waymark, node, and the GitHub CLI and sign them in, initialize the tracker, install the rules and the runtimes, write the AGENTS.md pointer, and open the first map. Use when the project has no .waymark/config.toml, when .agents/rules/ is empty, or when a clone cannot run the set.
weave-your-work/setup/ on GitHub (opens in a new tab)SKILL.md -
split
Turn a settled layer of a map into its next children: decide whether the layer is child maps or tasks, decide how many, and start each child through the action that writes it. Use when a map's layer is settled and its children do not exist yet.
weave-your-work/split/ on GitHub (opens in a new tab)SKILL.md -
stop-and-wait
Step out of the record in front of you and read the whole project: report where two targets, a promise and its artifact, or two rules contradict each other, into a report, and change no record. Use when a person asks whether the project is still consistent, or before a large split or a restart.
weave-your-work/stop-and-wait/ on GitHub (opens in a new tab)SKILL.md -
task-review
Judge a finished task against the acceptance signal written before the work started, give each axis its own verdict, and record both with their evidence. Use when a task has a Result and has to close, or when a task comes back after a fix.
weave-your-work/task-review/ on GitHub (opens in a new tab)SKILL.md -
task
The reference for a task record: the sections a body may hold, the delivery and probe kinds, and the two review axes. Read it before writing, advancing, or judging a task.
weave-your-work/task/ on GitHub (opens in a new tab)SKILL.md -
update
Change a record that other records already rely on: edit it in place, strike the old text and reopen it, or retire it and open a replacement, then carry the change to its children, its dependents, and its links. Use when a closed record, or a map that has already split, has to change.
weave-your-work/update/ on GitHub (opens in a new tab)SKILL.md -
use-weave-your-work-examples
Two worked examples of the set in use: a chemistry lab and a shop's restock list, each taken from a map through its split, its task runs, and its reviews. Use when a skill's rules are too abstract to act on and a page written earlier is easier to follow.
weave-your-work/use-weave-your-work-examples/ on GitHub (opens in a new tab)SKILL.md -
wait-what
Stop the work and show where it stands: read the state off the records, not the conversation, and report it in one short table with fixed columns. Use when a person asks where the work is, what is left, or who is waiting on whom.
weave-your-work/wait-what/ on GitHub (opens in a new tab)SKILL.md -
waymark
The record formats this set writes: every field and legal value, the relation rules, and the body of a map, a task, a testimony, an ADR, a glossary entry, an issue, a handoff, and a patrol report. Read it before writing a record; this is the only place they are defined.
weave-your-work/waymark/ on GitHub (opens in a new tab)SKILL.md -
what-is-the-mainline
What the order of the set is: the seven actions from a settled map to a closed one, what each hands to, the auxiliary actions that change a record without adding a step, and who writes which record kind. Read it to see what runs next and where a step stops; it describes the order and runs nothing.
weave-your-work/what-is-the-mainline/ on GitHub (opens in a new tab)SKILL.md -
whole-review
Read the children of one map against themselves, their siblings, and their parent, and report where the set does not hold together: a child that contradicts its own review, two that promise the same result, or one that reaches past the map's acceptance direction. Use when a person asks for a whole-map check before judging a map.
weave-your-work/whole-review/ on GitHub (opens in a new tab)SKILL.md
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.