{ "schemaVersion": "1.0", "item": { "slug": "tick-md", "name": "tick-md", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/gianni-dalerta/tick-md", "canonicalUrl": "https://clawhub.ai/gianni-dalerta/tick-md", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/tick-md", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tick-md", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "CHANGELOG.md", "INSTALL.md", "README.md", "SKILL.md", "mcp-reference.md", "roles/ORCHESTRATOR.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T17:22:31.273Z", "expiresAt": "2026-05-14T17:22:31.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/tick-md" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/tick-md", "agentPageUrl": "https://openagent3.xyz/skills/tick-md/agent", "manifestUrl": "https://openagent3.xyz/skills/tick-md/agent.json", "briefUrl": "https://openagent3.xyz/skills/tick-md/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Tick Multi-Agent Coordination", "body": "Coordinate work across human and AI agents using structured Markdown files. Users interact naturally with you, and you maintain tasks transparently in TICK.md." }, { "title": "Installation", "body": "Prerequisites: The Tick CLI and MCP server should already be installed and configured by your environment.\n\nFirst time setup? See INSTALL.md for editor-specific installation instructions." }, { "title": "Safety Boundaries", "body": "Ask for explicit user approval before editing editor MCP config files.\nAsk for explicit user approval before running any command that pushes to remote git (tick sync --push or git push).\nIf user approval is not explicit, use read-only/status commands and explain what write action is pending.\n\nQuick Check:\n\n# Verify CLI is available\ntick --version\n\n# Check if TICK.md exists in project\nls TICK.md\n\n# If not, initialize\ntick init" }, { "title": "Core Concept", "body": "Tick Protocol = Git-based task coordination via TICK.md files\n\nHuman-readable: Standard Markdown with YAML\nMachine-parseable: Structured for tools\nGit-backed: Full version control and audit trail\nLocal-first: No cloud required" }, { "title": "Check if Tick is initialized", "body": "ls TICK.md" }, { "title": "If not initialized", "body": "tick init" }, { "title": "Get current status", "body": "tick status" }, { "title": "1. User Asks You to Do Something", "body": "User: \"Can you refactor the authentication system?\"\n\nYour Actions:\n\n# 1. Create task\ntick add \"Refactor authentication system\" --priority high --tags backend,security\n\n# 2. Register yourself (first time only)\ntick agent register @your-name --type bot --roles \"engineer,refactoring\"\n\n# 3. Claim the task\ntick claim TASK-XXX @your-name\n\n# 4. Work on it (do the actual work)\n\n# 5. Add progress comments\ntick comment TASK-XXX @your-name --note \"Analyzing current auth flow\"\ntick comment TASK-XXX @your-name --note \"Refactored to use JWT tokens\"\n\n# 6. Mark complete\ntick done TASK-XXX @your-name" }, { "title": "2. User Asks About Project Status", "body": "User: \"What tasks are we working on?\"\n\n# Get comprehensive status\ntick status\n\n# Or filter and list tasks\ntick list --status in_progress\ntick list --claimed-by @bot-name\n\nSummarize the output naturally for the user." }, { "title": "3. Coordination with Other Agents", "body": "User: \"Have the other agents finished their tasks?\"\n\n# Check overall status\ntick status\n\n# List agents and their work\ntick agent list --verbose\n\n# Validate the project\ntick validate" }, { "title": "4. Breaking Down Complex Work", "body": "User: \"Build a user dashboard with charts and data export\"\n\nYour Actions:\n\n# Create parent task\ntick add \"Build user dashboard\" --priority high --tags frontend\n\n# Create subtasks with dependencies\ntick add \"Design dashboard layout\" --priority high --tags frontend,design\ntick add \"Implement data charts\" --priority medium --tags frontend,charts --depends-on TASK-XXX\ntick add \"Add CSV export\" --priority low --tags frontend,export --depends-on TASK-XXX\n\n# Visualize dependencies\ntick graph" }, { "title": "Project Management", "body": "tick init # Initialize new project\ntick status # View project overview\ntick list # List tasks with filters\ntick graph # Visualize dependencies\ntick watch # Monitor changes in real-time\ntick validate # Check for errors\ntick sync --pull # Pull latest changes\n# tick sync --push # Only with explicit user approval" }, { "title": "Task Operations", "body": "tick add \"Task title\" \\\n --priority high \\ # urgent|high|medium|low\n --tags backend,api \\ # Comma-separated tags\n --assigned-to @agent \\ # Assign to agent\n --depends-on TASK-001 \\ # Dependencies\n --estimated-hours 4 # Time estimate\n\ntick claim TASK-001 @agent # Claim task (sets in_progress)\ntick release TASK-001 @agent # Release task (back to todo)\ntick done TASK-001 @agent # Complete task\ntick reopen TASK-001 @agent # Reopen completed task\ntick delete TASK-001 # Delete a task\ntick comment TASK-001 @agent \\ # Add note\n --note \"Progress update\"\ntick edit TASK-001 \\ # Direct field edit\n --title \"New title\" \\\n --priority high \\\n --status in_progress" }, { "title": "Corrections & Recovery", "body": "tick reopen TASK-001 @agent # Reopen completed task\ntick reopen TASK-001 @agent \\ # Reopen and re-block dependents\n --re-block\n\ntick delete TASK-001 # Delete task, cleans up deps\ntick delete TASK-001 --force # Delete even if has dependents\n\ntick edit TASK-001 --title \"X\" # Change title\ntick edit TASK-001 --priority high # Change priority\ntick edit TASK-001 --status todo # Change status directly\ntick edit TASK-001 --tags a,b,c # Replace tags\ntick edit TASK-001 --add-tag new # Add tag\ntick edit TASK-001 --remove-tag old # Remove tag\ntick edit TASK-001 \\ # Edit dependencies\n --depends-on TASK-002,TASK-003\n\ntick undo # Undo last tick operation\ntick undo --dry-run # Preview what would be undone" }, { "title": "Bulk Operations", "body": "tick import tasks.yaml # Import tasks from YAML file\ntick import - < tasks.yaml # Import from stdin\ntick import tasks.yaml --dry-run # Preview import\n\ntick batch start # Begin batch mode (no auto-commit)\ntick batch status # Check batch status\ntick batch commit # Commit all batched changes\ntick batch abort # Discard batched changes" }, { "title": "Advanced Task Listing", "body": "tick list # All tasks, grouped by status\ntick list --status blocked # Only blocked tasks\ntick list --priority urgent # High-priority tasks\ntick list --assigned-to @alice # Tasks for specific agent\ntick list --tag backend # Tasks with tag\ntick list --json # JSON output for scripts" }, { "title": "Dependency Visualization", "body": "tick graph # ASCII dependency tree\ntick graph --format mermaid # Mermaid flowchart\ntick graph --show-done # Include completed tasks" }, { "title": "Real-time Monitoring", "body": "tick watch # Watch for changes\ntick watch --interval 10 # Custom polling interval\ntick watch --filter in_progress # Only show specific status" }, { "title": "Agent Management", "body": "tick agent register @name \\ # Register new agent\n --type bot \\ # human|bot\n --roles \"dev,qa\" \\ # Comma-separated roles\n --status idle # working|idle|offline\n\ntick agent list # List all agents\ntick agent list --verbose # Detailed info\ntick agent list --type bot # Filter by type\ntick agent list --status working # Filter by status" }, { "title": "MCP Tools (Alternative to CLI)", "body": "If using Model Context Protocol, use these tools instead of CLI commands:" }, { "title": "Status and Inspection", "body": "tick_status - Get project status (agents, tasks, progress)\ntick_validate - Validate TICK.md structure\ntick_agent_list - List agents with optional filters" }, { "title": "Task Management", "body": "tick_add - Create new task\ntick_claim - Claim task for agent\ntick_release - Release claimed task\ntick_done - Complete task (auto-unblocks dependents)\ntick_comment - Add note to task" }, { "title": "Corrections & Recovery", "body": "tick_reopen - Reopen completed task\ntick_delete - Delete a task\ntick_edit - Direct field edit (bypasses state machine)\ntick_undo - Undo last tick operation" }, { "title": "Agent Operations", "body": "tick_agent_register - Register new agent\n\nMCP Example:\n\n// Create task via MCP\nawait tick_add({\n title: \"Refactor authentication\",\n priority: \"high\",\n tags: [\"backend\", \"security\"],\n assignedTo: \"@bot-name\"\n})\n\n// Claim it\nawait tick_claim({\n taskId: \"TASK-023\",\n agent: \"@bot-name\"\n})" }, { "title": "1. Natural Conversation First", "body": "✅ Good: User says \"refactor the auth\", you create task automatically\n❌ Bad: Making user explicitly create tasks" }, { "title": "2. Always Use Your Agent Name", "body": "Register once:\n\ntick agent register @your-bot-name --type bot --roles \"engineer\"\n\nThen use consistently:\n\ntick claim TASK-001 @your-bot-name\ntick done TASK-001 @your-bot-name" }, { "title": "3. Provide Context in Comments", "body": "# ✅ Good - explains what and why\ntick comment TASK-005 @bot --note \"Switched from REST to GraphQL for better type safety and reduced over-fetching\"\n\n# ❌ Bad - too vague\ntick comment TASK-005 @bot --note \"Updated API\"" }, { "title": "4. Break Down Large Tasks", "body": "Create subtasks with dependencies:\n\ntick add \"Set up CI/CD pipeline\" --priority high\ntick add \"Configure GitHub Actions\" --depends-on TASK-010\ntick add \"Add deployment scripts\" --depends-on TASK-011\ntick add \"Set up staging environment\" --depends-on TASK-011" }, { "title": "5. Check Status Before Claiming", "body": "# Make sure task exists and isn't claimed\ntick status\n\n# Then claim\ntick claim TASK-XXX @your-name" }, { "title": "Understanding TICK.md Structure", "body": "The file has three sections:\n\nFrontmatter (YAML): Project metadata\nAgents Table (Markdown): Who's working on what\nTask Blocks (YAML + Markdown): Individual tasks with history\n\nExample:\n\n---\nproject: my-app\nschema_version: \"1.0\"\nnext_id: 5\n---\n\n# Agents\n\n| Name | Type | Roles | Status | Working On |\n|------|------|-------|--------|------------|\n| @alice | human | owner | working | TASK-003 |\n| @bot | bot | engineer | idle | - |\n\n# Tasks\n\n\\```yaml\nid: TASK-001\ntitle: Build authentication\nstatus: done\npriority: high\nclaimed_by: null\n# ... more fields\nhistory:\n - ts: 2026-02-07T10:00:00Z\n who: @bot\n action: created\n - ts: 2026-02-07T14:00:00Z\n who: @bot\n action: done\n\\```\n\nImplemented JWT-based authentication with token refresh..." }, { "title": "Automatic Dependency Unblocking", "body": "When you complete a task, dependent tasks automatically unblock:\n\n# TASK-002 depends on TASK-001\n# TASK-002 status: blocked\n\ntick done TASK-001 @bot\n# TASK-002 automatically changes to: todo" }, { "title": "Circular Dependency Detection", "body": "Validation catches circular dependencies:\n\ntick validate\n# Error: Circular dependency detected: TASK-001 → TASK-002 → TASK-003 → TASK-001" }, { "title": "Smart Commit Messages", "body": "# Only run with explicit user approval\ntick sync --push\n# Automatically generates: \"feat: complete TASK-001, TASK-002; update TASK-003\"" }, { "title": "Reopening Completed Tasks", "body": "If a task was marked done prematurely:\n\ntick reopen TASK-001 @bot\n# Sets status back to in_progress, records in history\n\ntick reopen TASK-001 @bot --re-block\n# Also re-blocks any tasks that depend on this one" }, { "title": "Fixing Mistakes", "body": "# Undo the last tick operation\ntick undo\n\n# Preview what would be undone first\ntick undo --dry-run\n\n# Direct field edits (bypasses state machine)\ntick edit TASK-001 --status todo --priority urgent" }, { "title": "Batch Operations", "body": "For multiple changes without individual commits:\n\ntick batch start\n# Now make multiple changes...\ntick add \"Task 1\" --priority high\ntick add \"Task 2\" --priority medium\ntick claim TASK-001 @bot\n# ...\ntick batch commit # Single commit for all changes\n# Or: tick batch abort # Discard all changes" }, { "title": "Real-time Monitoring", "body": "tick watch\n# [10:23:45] ✓ Added: TASK-015 - Implement user search\n# [10:24:12] 🔒 TASK-015 claimed by @bot\n# [10:26:33] ⟳ TASK-015: in_progress → done" }, { "title": "Quick Reference Card", "body": "Workflow: init → add → claim → work → comment → done → sync\nEssential: status | add | claim | done | list | graph\nCorrections: reopen | delete | edit | undo\nBulk: import | batch start/commit/abort\nCoordination: agent register | agent list | validate | watch\nGit: sync --pull | sync --push (explicit user approval required)" }, { "title": "Key Reminders", "body": "Users interact with YOU, not with Tick directly\nYOU maintain the TICK.md transparently\nDashboard is for inspection, not primary interaction\nAlways use your agent name consistently\nComment frequently to show progress\nValidate before syncing\nCheck status before claiming\nBreak down complex work into subtasks" }, { "title": "Resources", "body": "GitHub: https://github.com/your-org/tick-md\nDocumentation: https://tick-md.dev/docs\nCLI npm: https://npmjs.com/package/tick-md\nMCP Server npm: https://npmjs.com/package/tick-mcp-server" }, { "title": "License", "body": "MIT" } ], "body": "Tick Multi-Agent Coordination\n\nCoordinate work across human and AI agents using structured Markdown files. Users interact naturally with you, and you maintain tasks transparently in TICK.md.\n\nInstallation\n\nPrerequisites: The Tick CLI and MCP server should already be installed and configured by your environment.\n\nFirst time setup? See INSTALL.md for editor-specific installation instructions.\n\nSafety Boundaries\nAsk for explicit user approval before editing editor MCP config files.\nAsk for explicit user approval before running any command that pushes to remote git (tick sync --push or git push).\nIf user approval is not explicit, use read-only/status commands and explain what write action is pending.\n\nQuick Check:\n\n# Verify CLI is available\ntick --version\n\n# Check if TICK.md exists in project\nls TICK.md\n\n# If not, initialize\ntick init\n\nCore Concept\n\nTick Protocol = Git-based task coordination via TICK.md files\n\nHuman-readable: Standard Markdown with YAML\nMachine-parseable: Structured for tools\nGit-backed: Full version control and audit trail\nLocal-first: No cloud required\nQuick Start\nCheck if Tick is initialized\nls TICK.md\n\nIf not initialized\ntick init\n\nGet current status\ntick status\n\nCommon Workflows\n1. User Asks You to Do Something\n\nUser: \"Can you refactor the authentication system?\"\n\nYour Actions:\n\n# 1. Create task\ntick add \"Refactor authentication system\" --priority high --tags backend,security\n\n# 2. Register yourself (first time only)\ntick agent register @your-name --type bot --roles \"engineer,refactoring\"\n\n# 3. Claim the task\ntick claim TASK-XXX @your-name\n\n# 4. Work on it (do the actual work)\n\n# 5. Add progress comments\ntick comment TASK-XXX @your-name --note \"Analyzing current auth flow\"\ntick comment TASK-XXX @your-name --note \"Refactored to use JWT tokens\"\n\n# 6. Mark complete\ntick done TASK-XXX @your-name\n\n2. User Asks About Project Status\n\nUser: \"What tasks are we working on?\"\n\n# Get comprehensive status\ntick status\n\n# Or filter and list tasks\ntick list --status in_progress\ntick list --claimed-by @bot-name\n\n\nSummarize the output naturally for the user.\n\n3. Coordination with Other Agents\n\nUser: \"Have the other agents finished their tasks?\"\n\n# Check overall status\ntick status\n\n# List agents and their work\ntick agent list --verbose\n\n# Validate the project\ntick validate\n\n4. Breaking Down Complex Work\n\nUser: \"Build a user dashboard with charts and data export\"\n\nYour Actions:\n\n# Create parent task\ntick add \"Build user dashboard\" --priority high --tags frontend\n\n# Create subtasks with dependencies\ntick add \"Design dashboard layout\" --priority high --tags frontend,design\ntick add \"Implement data charts\" --priority medium --tags frontend,charts --depends-on TASK-XXX\ntick add \"Add CSV export\" --priority low --tags frontend,export --depends-on TASK-XXX\n\n# Visualize dependencies\ntick graph\n\nCommand Reference\nProject Management\ntick init # Initialize new project\ntick status # View project overview\ntick list # List tasks with filters\ntick graph # Visualize dependencies\ntick watch # Monitor changes in real-time\ntick validate # Check for errors\ntick sync --pull # Pull latest changes\n# tick sync --push # Only with explicit user approval\n\nTask Operations\ntick add \"Task title\" \\\n --priority high \\ # urgent|high|medium|low\n --tags backend,api \\ # Comma-separated tags\n --assigned-to @agent \\ # Assign to agent\n --depends-on TASK-001 \\ # Dependencies\n --estimated-hours 4 # Time estimate\n\ntick claim TASK-001 @agent # Claim task (sets in_progress)\ntick release TASK-001 @agent # Release task (back to todo)\ntick done TASK-001 @agent # Complete task\ntick reopen TASK-001 @agent # Reopen completed task\ntick delete TASK-001 # Delete a task\ntick comment TASK-001 @agent \\ # Add note\n --note \"Progress update\"\ntick edit TASK-001 \\ # Direct field edit\n --title \"New title\" \\\n --priority high \\\n --status in_progress\n\nCorrections & Recovery\ntick reopen TASK-001 @agent # Reopen completed task\ntick reopen TASK-001 @agent \\ # Reopen and re-block dependents\n --re-block\n\ntick delete TASK-001 # Delete task, cleans up deps\ntick delete TASK-001 --force # Delete even if has dependents\n\ntick edit TASK-001 --title \"X\" # Change title\ntick edit TASK-001 --priority high # Change priority\ntick edit TASK-001 --status todo # Change status directly\ntick edit TASK-001 --tags a,b,c # Replace tags\ntick edit TASK-001 --add-tag new # Add tag\ntick edit TASK-001 --remove-tag old # Remove tag\ntick edit TASK-001 \\ # Edit dependencies\n --depends-on TASK-002,TASK-003\n\ntick undo # Undo last tick operation\ntick undo --dry-run # Preview what would be undone\n\nBulk Operations\ntick import tasks.yaml # Import tasks from YAML file\ntick import - < tasks.yaml # Import from stdin\ntick import tasks.yaml --dry-run # Preview import\n\ntick batch start # Begin batch mode (no auto-commit)\ntick batch status # Check batch status\ntick batch commit # Commit all batched changes\ntick batch abort # Discard batched changes\n\nAdvanced Task Listing\ntick list # All tasks, grouped by status\ntick list --status blocked # Only blocked tasks\ntick list --priority urgent # High-priority tasks\ntick list --assigned-to @alice # Tasks for specific agent\ntick list --tag backend # Tasks with tag\ntick list --json # JSON output for scripts\n\nDependency Visualization\ntick graph # ASCII dependency tree\ntick graph --format mermaid # Mermaid flowchart\ntick graph --show-done # Include completed tasks\n\nReal-time Monitoring\ntick watch # Watch for changes\ntick watch --interval 10 # Custom polling interval\ntick watch --filter in_progress # Only show specific status\n\nAgent Management\ntick agent register @name \\ # Register new agent\n --type bot \\ # human|bot\n --roles \"dev,qa\" \\ # Comma-separated roles\n --status idle # working|idle|offline\n\ntick agent list # List all agents\ntick agent list --verbose # Detailed info\ntick agent list --type bot # Filter by type\ntick agent list --status working # Filter by status\n\nMCP Tools (Alternative to CLI)\n\nIf using Model Context Protocol, use these tools instead of CLI commands:\n\nStatus and Inspection\ntick_status - Get project status (agents, tasks, progress)\ntick_validate - Validate TICK.md structure\ntick_agent_list - List agents with optional filters\nTask Management\ntick_add - Create new task\ntick_claim - Claim task for agent\ntick_release - Release claimed task\ntick_done - Complete task (auto-unblocks dependents)\ntick_comment - Add note to task\nCorrections & Recovery\ntick_reopen - Reopen completed task\ntick_delete - Delete a task\ntick_edit - Direct field edit (bypasses state machine)\ntick_undo - Undo last tick operation\nAgent Operations\ntick_agent_register - Register new agent\n\nMCP Example:\n\n// Create task via MCP\nawait tick_add({\n title: \"Refactor authentication\",\n priority: \"high\",\n tags: [\"backend\", \"security\"],\n assignedTo: \"@bot-name\"\n})\n\n// Claim it\nawait tick_claim({\n taskId: \"TASK-023\",\n agent: \"@bot-name\"\n})\n\nBest Practices\n1. Natural Conversation First\n\n✅ Good: User says \"refactor the auth\", you create task automatically ❌ Bad: Making user explicitly create tasks\n\n2. Always Use Your Agent Name\n\nRegister once:\n\ntick agent register @your-bot-name --type bot --roles \"engineer\"\n\n\nThen use consistently:\n\ntick claim TASK-001 @your-bot-name\ntick done TASK-001 @your-bot-name\n\n3. Provide Context in Comments\n# ✅ Good - explains what and why\ntick comment TASK-005 @bot --note \"Switched from REST to GraphQL for better type safety and reduced over-fetching\"\n\n# ❌ Bad - too vague\ntick comment TASK-005 @bot --note \"Updated API\"\n\n4. Break Down Large Tasks\n\nCreate subtasks with dependencies:\n\ntick add \"Set up CI/CD pipeline\" --priority high\ntick add \"Configure GitHub Actions\" --depends-on TASK-010\ntick add \"Add deployment scripts\" --depends-on TASK-011\ntick add \"Set up staging environment\" --depends-on TASK-011\n\n5. Check Status Before Claiming\n# Make sure task exists and isn't claimed\ntick status\n\n# Then claim\ntick claim TASK-XXX @your-name\n\nUnderstanding TICK.md Structure\n\nThe file has three sections:\n\nFrontmatter (YAML): Project metadata\nAgents Table (Markdown): Who's working on what\nTask Blocks (YAML + Markdown): Individual tasks with history\n\nExample:\n\n---\nproject: my-app\nschema_version: \"1.0\"\nnext_id: 5\n---\n\n# Agents\n\n| Name | Type | Roles | Status | Working On |\n|------|------|-------|--------|------------|\n| @alice | human | owner | working | TASK-003 |\n| @bot | bot | engineer | idle | - |\n\n# Tasks\n\n\\```yaml\nid: TASK-001\ntitle: Build authentication\nstatus: done\npriority: high\nclaimed_by: null\n# ... more fields\nhistory:\n - ts: 2026-02-07T10:00:00Z\n who: @bot\n action: created\n - ts: 2026-02-07T14:00:00Z\n who: @bot\n action: done\n\\```\n\nImplemented JWT-based authentication with token refresh...\n\nAdvanced Features\nAutomatic Dependency Unblocking\n\nWhen you complete a task, dependent tasks automatically unblock:\n\n# TASK-002 depends on TASK-001\n# TASK-002 status: blocked\n\ntick done TASK-001 @bot\n# TASK-002 automatically changes to: todo\n\nCircular Dependency Detection\n\nValidation catches circular dependencies:\n\ntick validate\n# Error: Circular dependency detected: TASK-001 → TASK-002 → TASK-003 → TASK-001\n\nSmart Commit Messages\n# Only run with explicit user approval\ntick sync --push\n# Automatically generates: \"feat: complete TASK-001, TASK-002; update TASK-003\"\n\nReopening Completed Tasks\n\nIf a task was marked done prematurely:\n\ntick reopen TASK-001 @bot\n# Sets status back to in_progress, records in history\n\ntick reopen TASK-001 @bot --re-block\n# Also re-blocks any tasks that depend on this one\n\nFixing Mistakes\n# Undo the last tick operation\ntick undo\n\n# Preview what would be undone first\ntick undo --dry-run\n\n# Direct field edits (bypasses state machine)\ntick edit TASK-001 --status todo --priority urgent\n\nBatch Operations\n\nFor multiple changes without individual commits:\n\ntick batch start\n# Now make multiple changes...\ntick add \"Task 1\" --priority high\ntick add \"Task 2\" --priority medium\ntick claim TASK-001 @bot\n# ...\ntick batch commit # Single commit for all changes\n# Or: tick batch abort # Discard all changes\n\nReal-time Monitoring\ntick watch\n# [10:23:45] ✓ Added: TASK-015 - Implement user search\n# [10:24:12] 🔒 TASK-015 claimed by @bot\n# [10:26:33] ⟳ TASK-015: in_progress → done\n\nQuick Reference Card\nWorkflow: init → add → claim → work → comment → done → sync\nEssential: status | add | claim | done | list | graph\nCorrections: reopen | delete | edit | undo\nBulk: import | batch start/commit/abort\nCoordination: agent register | agent list | validate | watch\nGit: sync --pull | sync --push (explicit user approval required)\n\nKey Reminders\nUsers interact with YOU, not with Tick directly\nYOU maintain the TICK.md transparently\nDashboard is for inspection, not primary interaction\nAlways use your agent name consistently\nComment frequently to show progress\nValidate before syncing\nCheck status before claiming\nBreak down complex work into subtasks\nResources\nGitHub: https://github.com/your-org/tick-md\nDocumentation: https://tick-md.dev/docs\nCLI npm: https://npmjs.com/package/tick-md\nMCP Server npm: https://npmjs.com/package/tick-mcp-server\nLicense\n\nMIT" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/gianni-dalerta/tick-md", "publisherUrl": "https://clawhub.ai/gianni-dalerta/tick-md", "owner": "gianni-dalerta", "version": "1.3.3", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/tick-md", "downloadUrl": "https://openagent3.xyz/downloads/tick-md", "agentUrl": "https://openagent3.xyz/skills/tick-md/agent", "manifestUrl": "https://openagent3.xyz/skills/tick-md/agent.json", "briefUrl": "https://openagent3.xyz/skills/tick-md/agent.md" } }