diff --git a/.github/ISSUE_TEMPLATE/blocked-human.md b/.github/ISSUE_TEMPLATE/blocked-human.md new file mode 100644 index 0000000..834e36c --- /dev/null +++ b/.github/ISSUE_TEMPLATE/blocked-human.md @@ -0,0 +1,19 @@ +--- +name: "๐Ÿšง Blocked on human action" +about: A task stalled on external human action (DUA/DSA signature, sign-up, records-release email, IRB response, etc). Surfaced automatically in the weekly stalled-work digest โ€” stays visible for as long as it's open. +title: "[blocked-human] " +labels: [] +assignees: '' +--- + +## What's needed + + +## Why it's blocking + + +## Waiting on + + +## Next step + diff --git a/.github/ISSUE_TEMPLATE/followup.md b/.github/ISSUE_TEMPLATE/followup.md new file mode 100644 index 0000000..adaae04 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/followup.md @@ -0,0 +1,13 @@ +--- +name: "๐Ÿ“… Dated follow-up" +about: A task with a specific date to check back in. Only surfaces in the weekly stalled-work digest once that date has passed. +title: "[followup: YYYY-MM-DD] " +labels: [] +assignees: '' +--- + +## What to check + + +## Why it matters + diff --git a/README.md b/README.md index aa81daa..93c25ed 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,13 @@ A personal collection of [Agent Skills](https://agentskills.io) โ€” portable, se Each skill is a folder containing a `SKILL.md` file (instructions + metadata) and, where needed, supporting `scripts/`, `references/`, or `assets/`. Nothing here is Claude-specific unless explicitly noted โ€” see [CONTRIBUTING.md](./CONTRIBUTING.md) for the portability rules this repo follows. +> [!IMPORTANT] +> **Stalled-work tracking.** Tasks blocked on external human action โ€” a DUA/DSA signature, an account sign-up, a records-release email, an IRB response โ€” are tracked as GitHub issues, not left to memory. Open one with the **๐Ÿšง Blocked on human action** or **๐Ÿ“… Dated follow-up** issue template (top of "New Issue"); the title tag (`[blocked-human] ...` / `[followup: YYYY-MM-DD] ...`) is what a weekly automated digest scans for across every public repo here, pushed as a phone notification so nothing silently rots. +> +> Browse current items: [blocked](https://github.com/Hefrock/agent-skills/issues?q=is%3Aopen+is%3Aissue+%5Bblocked-human%5D+in%3Atitle) ยท [pending follow-ups](https://github.com/Hefrock/agent-skills/issues?q=is%3Aopen+is%3Aissue+%5Bfollowup%3A+in%3Atitle) *(GitHub's search UI tokenizes brackets loosely โ€” these links are a convenience, not authoritative; the digest itself does an exact title-prefix match via the API)*. +> +> **Resolve:** close the issue. **Update:** edit it โ€” the digest reads live state, nothing to sync. **Postpone:** change the `YYYY-MM-DD` in a follow-up's title; a `[blocked-human]` item has no date by design, so it keeps resurfacing until closed. + ## Skills | Skill | Category | Description | @@ -51,7 +58,8 @@ Copy the skill folder into whatever directory that platform scans for skills โ€” ``` agent-skills/ โ”œโ”€โ”€ .github/ -โ”‚ โ””โ”€โ”€ workflows/ci.yml # builds + tests the MCP server, runs the Python skill suites +โ”‚ โ”œโ”€โ”€ workflows/ci.yml # builds + tests the MCP server, runs the Python skill suites +โ”‚ โ””โ”€โ”€ ISSUE_TEMPLATE/ # blocked-human / dated-followup templates for stalled-work tracking โ”œโ”€โ”€ .claude-plugin/ โ”‚ โ””โ”€โ”€ marketplace.json # Claude Code-only install metadata โ€” optional, additive โ”œโ”€โ”€ skills/ # flat โ€” one folder per skill, no category nesting