docs: rename to CoWork Repository Update, bump to v1.1
This commit is contained in:
@@ -1,11 +1,11 @@
|
|||||||
# cowork-project
|
# CoWork Repository Update
|
||||||
|
|
||||||
CoWork skill that manages the full coordination lifecycle for MPM CoWork skills and plugins.
|
CoWork skill that manages the full coordination lifecycle for MPM CoWork skills and plugins.
|
||||||
|
|
||||||
**Version:** 1.0
|
**Version:** 1.1
|
||||||
**Author:** Message Point Media
|
**Author:** Message Point Media
|
||||||
**Repo:** https://git.alwisp.com/jason/cowork-project
|
**Repo:** https://git.alwisp.com/jason/cowork-project
|
||||||
**CoWork Project:** CW-002 — CoWork Project Coordination
|
**CoWork Project:** CW-002 — CoWork Repository Update
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -19,7 +19,7 @@ This skill automates every coordination step that must happen when a new CoWork
|
|||||||
|
|
||||||
| Skill | What It Does |
|
| Skill | What It Does |
|
||||||
|---|---|
|
|---|---|
|
||||||
| `cowork-project` | Manages the full CoWork project coordination lifecycle. Triggers on: "new skill idea", "I want to build a plugin for X", "let's capture this concept", "add a new project to the registry", "create the entry for this", "document this plugin", "update the wiki", "add to the coordination folder", "set up the project folder", "package the plugin", "we just finished building", "update the registry for". Runs Mode 1 (concept interview) or Mode 2 (document existing build) depending on context. |
|
| `cowork-repository-update` | Manages the full CoWork project coordination lifecycle. Triggers on: "new skill idea", "I want to build a plugin for X", "let's capture this concept", "add a new project to the registry", "create the entry for this", "document this plugin", "update the wiki", "add to the coordination folder", "set up the project folder", "package the plugin", "we just finished building", "update the registry for". Runs Mode 1 (concept interview) or Mode 2 (document existing build) depending on context. |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -85,7 +85,7 @@ Full 10-step process for creating or refreshing all coordination artifacts for a
|
|||||||
3. **Determine CW-ID and registry state** — read existing row if one exists; only update changed fields
|
3. **Determine CW-ID and registry state** — read existing row if one exists; only update changed fields
|
||||||
4. **Create Drive folder** — `CW-XXX — [Project Name]` in Coordination folder (or use existing)
|
4. **Create Drive folder** — `CW-XXX — [Project Name]` in Coordination folder (or use existing)
|
||||||
5. **Write README.md** — thorough; if SKILL.md lists 12 tools, README lists all 12; push to Drive folder AND Git repo
|
5. **Write README.md** — thorough; if SKILL.md lists 12 tools, README lists all 12; push to Drive folder AND Git repo
|
||||||
6. **Package .skill file** — skill-only: zip `.claude-plugin/plugin.json` + `skills/`; with server: include `server/` and `.mcp.json`; upload to Drive folder
|
6. **Package .skill file** — skill-only: stage into single top-level folder with SKILL.md at root; with server: zip server/ + .mcp.json + plugin.json + SKILL.md; upload to Drive folder
|
||||||
7. **Create or update Wiki Doc** — V2 5-section format; use `create_doc` → `update_drive_file add_parents` → `batch_update_doc`; if updating, prepend changelog row only
|
7. **Create or update Wiki Doc** — V2 5-section format; use `create_doc` → `update_drive_file add_parents` → `batch_update_doc`; if updating, prepend changelog row only
|
||||||
8. **Verify all 3 artifacts** in Drive folder before registry write
|
8. **Verify all 3 artifacts** in Drive folder before registry write
|
||||||
9. **Update registry** — correct-order insertion; update Version, Drive Folder, Wiki Doc, Last Updated, Notes
|
9. **Update registry** — correct-order insertion; update Version, Drive Folder, Wiki Doc, Last Updated, Notes
|
||||||
@@ -96,7 +96,7 @@ Full 10-step process for creating or refreshing all coordination artifacts for a
|
|||||||
- Thin README is worse than no README — pull every tool, every trigger phrase
|
- Thin README is worse than no README — pull every tool, every trigger phrase
|
||||||
- For backfill CW-IDs, read all column A values and shift rows at insertion point downward
|
- For backfill CW-IDs, read all column A values and shift rows at insertion point downward
|
||||||
- Confirm version number before writing any artifacts
|
- Confirm version number before writing any artifacts
|
||||||
- Wiki Concept section: 3–5 sentences minimum; all trigger phrases in Skills Exposed
|
- Skill-only .skill zip: ONE top-level folder, SKILL.md directly inside (not nested deeper)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -140,9 +140,9 @@ This is a skill-only plugin — no server installation required.
|
|||||||
- Gitea MCP connected to `https://git.alwisp.com` (provides repo tools)
|
- Gitea MCP connected to `https://git.alwisp.com` (provides repo tools)
|
||||||
|
|
||||||
**Install:**
|
**Install:**
|
||||||
1. Install from the `.skill` file: Claude Desktop → Settings → Plugins → Add Plugin → select `cowork-project-v1.0.skill`
|
1. Install from the `.skill` file: Claude Desktop → Settings → Plugins → Add Plugin → select `cowork-repository-update-v1.1.skill`
|
||||||
2. Restart Claude Desktop
|
2. Restart Claude Desktop
|
||||||
3. Verify: ask Claude "what's the cowork-project skill for?" — it should describe the coordination workflow
|
3. Verify: ask Claude "what's the CoWork Repository Update skill for?" — it should describe the coordination workflow
|
||||||
|
|
||||||
### Setup Checklist
|
### Setup Checklist
|
||||||
|
|
||||||
@@ -164,6 +164,15 @@ This is a skill-only plugin — no server installation required.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## Changelog
|
||||||
|
|
||||||
|
| Date | Version | What Changed |
|
||||||
|
|---|---|---|
|
||||||
|
| 2026-05-05 | v1.1 | Renamed to CoWork Repository Update. Fixed skill-only .skill packaging: zip must have one top-level folder with SKILL.md at root (not nested under skills/). |
|
||||||
|
| 2026-05-05 | v1.0 | Initial release. Mode 1 concept interview + Mode 2 document existing build. |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Troubleshooting
|
## Troubleshooting
|
||||||
|
|
||||||
| Symptom | Fix |
|
| Symptom | Fix |
|
||||||
@@ -171,5 +180,5 @@ This is a skill-only plugin — no server installation required.
|
|||||||
| OSError Errno 35 when writing files | Never use local FUSE path — use `create_drive_file` or `create_doc` via Drive API |
|
| OSError Errno 35 when writing files | Never use local FUSE path — use `create_drive_file` or `create_doc` via Drive API |
|
||||||
| CW-ID collision (duplicate assigned) | Read ALL column A values; parse as integers; take max+1; ask user first for designated IDs |
|
| CW-ID collision (duplicate assigned) | Read ALL column A values; parse as integers; take max+1; ask user first for designated IDs |
|
||||||
| Wiki doc fails to appear in Shared Drive folder | Use `create_doc` (lands in My Drive) then `update_drive_file` with `add_parents` to move |
|
| Wiki doc fails to appear in Shared Drive folder | Use `create_doc` (lands in My Drive) then `update_drive_file` with `add_parents` to move |
|
||||||
| .skill packaging fails | Use `zip -r /tmp/plugin-name.skill .claude-plugin/ skills/` from repo root; copy to outputs dir before Drive upload |
|
| .skill upload rejected ("Zip must contain exactly one top-level folder") | Stage into `/tmp/[skill-name]-pkg/[skill-name]/`, put SKILL.md directly there, zip the folder |
|
||||||
| Registry row out of order | Read all rows; shift from insertion point downward one row at a time; write new row at correct position |
|
| Registry row out of order | Read all rows; shift from insertion point downward one row at a time; write new row at correct position |
|
||||||
|
|||||||
Reference in New Issue
Block a user