### TaskList API Output Example
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/AGENT_TEAM_GUIDE.md
Provides an example of the output format for the TaskList function, showing task ID, status, subject, owner, and any blocking tasks. This is useful for monitoring progress and identifying available tasks.
```text
#1 [completed] Create plugin scaffold (owner: scaffold-builder)
#2 [in_progress] Create command files (owner: command-builder, blocked by: [])
#3 [in_progress] Create content-extraction skill (owner: extraction-skill-builder, blocked by: [])
#4 [pending] Create takeaways + quotes (no owner, blocked by: [1])
```
--------------------------------
### Plugin Manifest Example (JSON)
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/GLOSSARY.md
A basic example of a plugin manifest file, which is written in JSON. This file declares the plugin's name and version, serving as its metadata. It's analogous to package.json in Node.js or pom.xml in Maven.
```json
{
"name": "content-repurposing",
"version": "1.0.0"
}
```
--------------------------------
### TeamCreate API Example
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/AGENT_TEAM_GUIDE.md
Demonstrates how to create a new team with a specified name and an optional description. The team name must be unique and in kebab-case.
```yaml
TeamCreate:
team_name: "content-repurposing-plugin"
description: "Building a content repurposing plugin for Claude Cowork"
```
--------------------------------
### TaskCreate API Example
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/AGENT_TEAM_GUIDE.md
Shows how to create a new task within a team. Requires a subject and description, with an optional activeForm for display during execution. Task status defaults to 'pending'.
```yaml
TaskCreate:
subject: "Create plugin scaffold"
description: "Create .claude-plugin/plugin.json and 10 directories..."
activeForm: "Creating plugin scaffold"
```
--------------------------------
### GET /TaskList
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/AGENT_TEAM_GUIDE.md
Lists all tasks with summary information.
```APIDOC
## GET /TaskList
### Description
Lists all tasks with summary information including id, subject, status, owner, and blockedBy list.
### Method
GET
### Endpoint
/TaskList
### Response
#### Success Response (200)
- **tasks** (array) - List of task objects containing id, subject, status, owner, and blockedBy.
```
--------------------------------
### TaskUpdate API Examples (Dependency and Completion)
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/AGENT_TEAM_GUIDE.md
Illustrates two common use cases for TaskUpdate: setting task dependencies by adding blockedBy task IDs, and marking a task as completed. Task status can be updated to 'pending', 'in_progress', 'completed', or 'deleted'.
```yaml
TaskUpdate:
taskId: "2"
addBlockedBy: ["1"]
```
```yaml
TaskUpdate:
taskId: "1"
status: "completed"
```
--------------------------------
### Send Notifications and Shutdown Requests
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/AGENT_TEAM_GUIDE.md
This section illustrates message-based communication between agents and the team lead. It includes examples of sending unblock notifications, checking task progress, and initiating agent shutdown requests. The `SendMessage` tool is used for these interactions, specifying recipient, content, and summary.
```yaml
SendMessage:
type: message
recipient: command-builder
content: "Task #1 (scaffold) is complete. All directories exist. You are\n unblocked -- begin writing your command files."
summary: "Scaffold done, you are unblocked"
```
```yaml
SendMessage:
type: message
recipient: extraction-skill-builder
content: "You are the last agent still working. Status update?"
summary: "Checking progress on extraction skill"
```
```yaml
SendMessage:
type: shutdown_request
recipient: scaffold-builder
content: "Your task is complete. Shutting down."
```
--------------------------------
### GET /TaskGet
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/AGENT_TEAM_GUIDE.md
Retrieves full details of a specific task.
```APIDOC
## GET /TaskGet
### Description
Retrieves full details of a specific task, including the complete description.
### Method
GET
### Endpoint
/TaskGet
### Parameters
#### Query Parameters
- **taskId** (string) - Required - The task ID to retrieve.
### Response
#### Success Response (200)
- **task** (object) - Full task details including description.
```
--------------------------------
### Define Project Structure and Task Breakdown
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/AGENT_TEAM_GUIDE.md
This section details the initial planning phase for a plugin project. It involves defining the final output structure (files and directories) and breaking down the work into independent tasks with clear dependencies.
```text
meeting-notes/
.claude-plugin/plugin.json
commands/summarize.md
commands/action-items.md
commands/decisions.md
skills/meeting-summary/SKILL.md
skills/action-tracker/SKILL.md
```
```text
Task A: Create manifest + directories (must be first)
Task B: Create 3 command files (independent of skills)
Task C: Create meeting-summary skill (independent of other skills)
Task D: Create action-tracker skill (independent of other skills)
```
```text
Task A (scaffold)
+--+--+
| | |
v v v
B C D (all parallel after A)
```
--------------------------------
### Implement Platform-Adapted Content Pattern
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/PLUGIN_ARCHITECTURE.md
Demonstrates a structure for adapting a single core input into multiple platform-specific formats. This ensures content adheres to the unique conventions and constraints of various social and publishing channels.
```markdown
#### Newsletter Ideas (5-7 ideas)
#### Substack Notes Ideas (5-7 ideas)
#### Twitter/X Thread Ideas (3-5 ideas)
#### LinkedIn Post Ideas (5-7 ideas)
#### Short-form Video Ideas (3-5 ideas)
```
--------------------------------
### YAML Key-Value Pair Equivalents
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/DEVELOPER_GUIDE.md
Illustrates the equivalence of YAML key-value pairs with their counterparts in XML and Java properties files. This section highlights how YAML offers a more concise syntax for configuration data compared to XML and Java properties.
```markdown
| YAML | XML | Java Properties |
|------------------------------------|------------------------------------------|--------------------------|
| `name: content-extraction` | `content-extraction` | `name=content-extraction`|
| `disable-model-invocation: true` | `true` | `disable-model-invocation=true` |
```
--------------------------------
### Manually Create Plugin Directories (Bash)
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/TROUBLESHOOTING.md
Provides bash commands to manually create the necessary directory structure for the Claude plugin. This is a preventative step to ensure that file-writing agents have a target directory.
```bash
mkdir -p content-repurposing/.claude-plugin
mkdir -p content-repurposing/commands
mkdir -p content-repurposing/skills/content-extraction
```
--------------------------------
### POST /TeamCreate
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/AGENT_TEAM_GUIDE.md
Creates a new agent team with an empty task list.
```APIDOC
## POST /TeamCreate
### Description
Creates a new team with an empty task list.
### Method
POST
### Endpoint
/TeamCreate
### Parameters
#### Request Body
- **team_name** (string) - Required - Unique identifier for the team (kebab-case).
- **description** (string) - Optional - Human-readable description of the team's purpose.
### Request Example
{
"team_name": "content-repurposing-plugin",
"description": "Building a content repurposing plugin for Claude Cowork"
}
```
--------------------------------
### Fix YAML Frontmatter Special Characters (YAML)
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/TROUBLESHOOTING.md
Demonstrates how to correctly quote strings containing special characters like colons in YAML frontmatter to prevent parsing errors. This ensures that values are interpreted as intended by the plugin.
```yaml
# Wrong - the colon breaks parsing
description: Extract ideas: from content to posts
# Correct - quoted string
description: "Extract ideas: from content to posts"
```
--------------------------------
### Skill File Structure (Markdown)
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/DEVELOPER_GUIDE.md
Illustrates the structure of a skill definition file named SKILL.md. It includes YAML frontmatter for the skill's name and description, followed by a Markdown body that outlines the skill's purpose and a step-by-step process for Claude to follow.
```markdown
---
name: key-takeaways
description: Summarizes key takeaways from long-form content into structured bullet
lists and actionable insights. Use when creating show notes, content summaries,
SEO descriptions, or quick reference guides.
---
# Key Takeaways Skill
You are a content analyst who distills long-form content into its most valuable
insights. Your summaries are concise, scannable, and actionable.
## Process
### Step 1: Analyze the Source
Read the entire source content. Identify:
- Main thesis and supporting arguments
- Actionable advice and steps
- Surprising or counterintuitive insights
- Data points and statistics
- Tools, resources, or references mentioned
- Frameworks or mental models presented
### Step 2: Create Structured Summary
#### Executive Summary (2-3 sentences)
A brief overview of what the content covers and why it matters.
```
--------------------------------
### Creating Plugin Zip File on macOS/Linux
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/DEVELOPER_GUIDE.md
This bash script creates a zip archive of the content-repurposing plugin directory for distribution. It navigates into the directory and then zips its contents into a parent directory.
```bash
cd content-repurposing
zip -r ../content-repurposing-plugin.zip .
```
--------------------------------
### Validate YAML Frontmatter in Plugin Files
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/TROUBLESHOOTING.md
Checks for correct YAML frontmatter syntax in Markdown files used for Claude Cowork plugin commands and skills. Frontmatter must be enclosed by '---' on separate lines and contain essential fields like 'description'.
```yaml
---
description: "A brief explanation of the command or skill."
---
Content of the command or skill goes here.
```
--------------------------------
### Verify Plugin Zip File Structure
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/TROUBLESHOOTING.md
Ensures the correct directory structure for the Claude Cowork plugin zip file. The root of the zip must contain the plugin's main directory, which in turn contains the .claude-plugin directory with plugin.json, and command/skill directories.
```text
content-repurposing/
.claude-plugin/
plugin.json
commands/
all.md
extract.md
...
skills/
content-extraction/
SKILL.md
...
```
--------------------------------
### Create Team with TeamCreate API
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/AGENT_TEAM_GUIDE.md
This code snippet demonstrates how to create a new team using the TeamCreate API. It initializes the team configuration and an empty task list, analogous to setting up a project workspace.
```yaml
TeamCreate:
team_name: "meeting-notes-plugin"
description: "Building a meeting-notes plugin for Claude Cowork"
```
--------------------------------
### Matching Command to Skill Name in Claude Cowork
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/TROUBLESHOOTING.md
Troubleshoots issues where a command runs but does not invoke the correct skill. This involves ensuring the skill name referenced in the command file exactly matches the 'name' field in the skill's frontmatter. Both are case-sensitive and hyphen-sensitive.
```text
Use the **content-extraction** skill to analyze this content.
```
```yaml
---
name: content-extraction
---
```
--------------------------------
### Update All Command Documentation
Source: https://github.com/az9713/claude-cowork-content-plugin/blob/main/docs/DEVELOPER_GUIDE.md
This markdown snippet shows how to update the 'all.md' command file to include new commands and skills. It details adding entries under 'Commands (Quick Actions)' and 'Skills (Auto-invoked by Claude)' sections.
```markdown
- `/content-repurposing:instagram` - Generate Instagram captions from your content
- **instagram-caption** - Create Instagram captions with hooks, CTAs, and hashtags
```