todo
/todo
Dodaje, oznacza jako zrobione i pokazuje zadania w backlogu projektu: zgłoszenia na GitHubie lub plik brain/todos.md.
- Autor
- guangshinhaha ↗
- Repozytorium
- shinstack ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 5
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- SKILL.md zawiera komentarze HTML (5). Nie widać ich w podglądzie Markdown, a model je czyta.
Co robi i kiedy
Dodaje, oznacza jako zrobione i pokazuje zadania w backlogu projektu: zgłoszenia na GitHubie lub plik brain/todos.md.
Wyzwalacze z opisu
Oryginalny opis (EN)
Add, complete, view, or link plans to items in the project backlog (GitHub issues or brain/todos.md). Use when the user says "todo", "add a todo", "mark done", "what's on the backlog", "show todos", "list tasks", "check off", or wants to manage their task list.
Jak działa
- GitHub issues backend
- todos.md backend
Podgląd SKILL.md
---
name: todo
description: >-
Add, complete, view, or link plans to items in the project backlog (GitHub issues or
brain/todos.md). Use when the user says "todo", "add a todo", "mark done", "what's on the
backlog", "show todos", "list tasks", "check off", or wants to manage their task list.
---
# Todo
The one place that knows where the backlog lives. Other skills say "use the `todo` skill"; only this skill touches the backend.
**Pick the backend:** read `[adapters.backlog.scripts]` in `.noodle.toml`. If `sync` points at a `github/` adapter, the backlog is **GitHub issues**. Otherwise it is the **`brain/todos.md`** file.
## GitHub issues backend
Item IDs are issue numbers. Use the `gh` CLI.
- **View:** `gh issue list --state open`. Issues labelled `shinfactory-done` are finished on local main and waiting for a push; skip them.
- **Read:** `gh issue view N --json body --jq .body` gives the full body. The backlog's `description` is cut at 2,000 characters.
- **Add:** `gh issue create --title "<title>" --body "<goal, an observable Done when, out of scope>"`. Add `--label needs_plan` when it needs a plan before code. Report the new number. Never add the `ready` label (or `NOODLE_GH_LABEL`, if set): it is a person's permission to build.
- **Link a plan:** the issue body carries one line `Plan: brain/plans/NN-slug/overview.md`, where NN is the issue number. Add or replace it with `gh issue edit N --body-file <file>` (read the current body first with `gh issue view N --json body --jq .body`), and remove the `needs_plan` label.
- **Edit:** `gh issue edit N --title ...` or `--body-file ...`.
- **Send back:** tell the person why the factory won't build it, and take it out of the backlog until they fix it, with the backlog `stop` script (`stop` under `[adapters.backlog.scripts]` in `.noodle.toml`, normally `defaults/adapters/github/backlog-stop`), run from the project root: `printf '%s' "<reason>. Fix the issue, then add the ${NOODLE_GH_LABEL:-ready} label again." | <stop script> N`. It comments once ("shinfactory: stopped. ..."), removes `ready` and adds `needs-shin`. Never just unlabel `ready` with `gh issue edit` for this: the issue would show no `needs-shin`.
- **Mark done:** inside a factory order, don't close the issue; the loop labels it `shinfactory-done`, and the human's push with `Closes #N` closes it. Outside the factory, close with a reason: `gh issue close N --comment "<why>"`, adding `--reason "not planned"` for an item that is outdated or superseded.
## todos.md backend
Manage the backlog at `brain/todos.md`. Edit the file directly with Edit/Write tools.
### File Format
```markdown
# Todos
<!-- next-id: 26 -->
## Section Name
1. [x] Completed item description
2. [ ] Open item description [[plans/02-some-plan/overview]]
```
- Items are numbered markdown checkboxes: `N. [ ] description` or `N. [x] description`
- Sections are `## Heading` groups
- `<!-- next-id: N -->` tracks the next available ID
### Operations
#### Add an item
1. Read `<!-- next-id: N -->` to get the next ID
2. Append `N. [ ] description` to the target section
3. Increment the next-id marker: `<!-- next-id: N+1 -->`
#### Mark done
Change `[ ]` to `[x]` and update the description with a reason:
```
2. [x] Old description — superseded by #75 channel UI redesign
```
Then move the done item from `brain/todos.md` to `brain/archive/todos.md` (create the file if it doesn't exist). Remove empty sections left behind.
#### Send back
Add the `#not_ready` tag and the reason to the item's line. The scheduler skips the item until a person fixes it and removes the tag:
```
3. [ ] Make it faster #not_ready (shinfactory: not built, no observable Done when)
```
#### Link a plan
Append `[[plans/NN-slug/overview]]` to the item's line, where NN is the item ID, and remove its `#needs_plan` tag.
#### Edit description
Replace the description text. Preserve any `[[wikilinks]]` unless intentionally removing them.
### Rules
- IDs are permanent. Never renumber or reuse them.
- Always increment `<!-- next-id -->` when adding items.
- Keep items in their section — don't move between sections without being asked.
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · guangshinhaha/shinstack | 100 | MIT |
| alexisjamet/todo-skill | 100 | MIT |
| markusleben/ha-nova | 100 | MIT |
| wangjs-jacky/jacky-skills | 100 | MIT |
| sejas/ai-code-skills | 100 | MIT |
| noahdunnagan/cafe | 100 | MIT |
| postmelee/hyper-waterfall | 100 | MIT |
| lnmunhoz/agent-ready-repo | 96 | MIT |
| Cruna-Noise-To-Signal/cruna-plugins | 90 | Apache-2.0 |
Migawka bazy z 13.11.2026 · wersja paczki f3a2a80a27f8 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100todos
Wyświetla, wyszukuje, tworzy, edytuje, kończy i przeplanowuje zadania w Aicoo. - 95todos
Prowadzi osobistą listę zadań wspólną dla sesji Claude: pokazuje, dodaje, zamyka i porządkuje pozycje. - 85super-productivity
Czyta i zarządza zadaniami użytkownika w Super Productivity przez wbudowane lokalne API: dodaje, oznacza jako zrobione i edytuje zadania. - 90todo-add
Dodaje wymaganie do listy zadań, gdy wiadomość zawiera polecenie TODO ADD z treścią wymagania. - 100tasks
Obsługuje listy zadań w plikach .llm/todo.md: wyciąga niezakończone pozycje, oznacza je jako zrobione i realizuje zadania. - 90todos-enhance
Doprecyzowuje zbyt niejasne zadania, które brzmią jak nagłówki, i rozbudowuje listę todo o konkret.