diff --git a/assets/SKILL.md b/assets/SKILL.md index c2a837b..5ed7c3a 100644 --- a/assets/SKILL.md +++ b/assets/SKILL.md @@ -173,10 +173,12 @@ worklane chown alice 1b78a24 # hand the ticket to someone worklane chown --clear 1b78a24 # hand it back to nobody ``` -`set` replaces, `append` adds, `--clear` empties. Neither `set` nor `append` has -`--owner` or `--status`: owner is `chown`'s and status is `mv`'s, so each field has -exactly one writer. A field set to the value it already holds is reported unchanged and -nothing is written, and so is a field cleared that was already unset. +`set` replaces, `append` adds, `--clear` empties. `set --tags` overwrites the whole +field: to add a tag to a ticket that already carries one, replace the value with every +tag separated by commas. Neither `set` nor `append` has `--owner` or `--status`: owner +is `chown`'s and status is `mv`'s, so each field has exactly one writer. A field set to +the value it already holds is reported unchanged and nothing is written, and so is a +field cleared that was already unset. **`--clear` takes the field as its value**, one of `due`, `tags`, `priority`, `description`, `acceptance` or `plan`, and repeats. It writes back exactly what `add`