{"id":"ebf50054-5e69-4144-ae71-e05669a756e2","entityType":"agent","slug":"clawhub-solomonfang-helios-kanban-skills","name":"Helios Kanban Remote","canonicalUrl":"https://www.xpersona.co/agent/clawhub-solomonfang-helios-kanban-skills","canonicalPath":"/agent/clawhub-solomonfang-helios-kanban-skills","generatedAt":"2026-10-10T05:25:03.184Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:11:38.926Z","emptyReason":null},"description":"Remote control Helios Kanban (helios-kanban) via REST API — list/create/update tasks, start/stop coding agents, follow-up, check status, handle approvals. Use when the user wants to control kanban from phone/chat, mentions Helios Kanban / helios-kanban / vibe-kanban remotely, or asks to create tasks, start agents, or check progress on a running instance. If the skill is not installed yet, read and follow INSTALL.md to self-install from GitHub first.","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.7K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s1740c8vy7zm5bfwdhwkr9hqhh8bk47a:helios-kanban-skills","sourceUrl":"https://clawhub.ai/solomonfang/helios-kanban-skills","homepage":"https://clawhub.ai/solomonfang/skills/helios-kanban-skills","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/solomonfang/helios-kanban-skills","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/solomonfang/skills/helios-kanban-skills","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":69,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Helios Kanban Remote technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:11:38.926Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:11:38.926Z","emptyReason":null},"stars":null,"forks":null,"downloads":2684,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"2.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:11:38.926Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T12:11:38.926Z","lastCrawledAt":"2026-10-09T12:11:38.926Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T12:11:38.926Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-07-31T07:36:49.606Z","changelog":"Initial release of Helios Kanban Remote skill. - Adds remote control for Helios Kanban via REST API: list, create, update tasks; start/stop coding agents; follow up; approve or deny processes; and check status. - Provides command-line interface (`hk.sh`) examples for typical workflows and operations. - Defines environment variable configuration for remote operations and project/repo defaults. - Clarifies feature scope, including actions requiring desktop/web access and safety rules for task deletion and network exposure. - Includes quick-reference tables for commands, statuses, priorities, and agent/executor names.","fileCount":9,"zipByteSize":19164}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1740c8vy7zm5bfwdhwkr9hqhh8bk47a:helios-kanban-skills","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s1740c8vy7zm5bfwdhwkr9hqhh8bk47a:helios-kanban-skills` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/solomonfang/helios-kanban-skills before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T05:25:03.183Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-solomonfang-helios-kanban-skills/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:11:38.926Z","emptyReason":null},"readme":"Skill: Helios Kanban Remote\n\nOwner: solomonfang\n\nSummary: Remote control Helios Kanban (helios-kanban) via REST API — list/create/update tasks, start/stop coding agents, follow-up, check status, handle approvals. Use when the user wants to control kanban from phone/chat, mentions Helios Kanban / helios-kanban / vibe-kanban remotely, or asks to create tasks, start agents, or check progress on a running instance. If the skill is not installed yet, read and follow INSTALL.md to self-install from GitHub first.\n\nTags: latest:0.1.0\n\nVersion history:\n\nv0.1.0 | 2026-07-31T07:36:49.606Z | auto\n\nInitial release of Helios Kanban Remote skill.\n\n- Adds remote control for Helios Kanban via REST API: list, create, update tasks; start/stop coding agents; follow up; approve or deny processes; and check status.\n- Provides command-line interface (`hk.sh`) examples for typical workflows and operations.\n- Defines environment variable configuration for remote operations and project/repo defaults.\n- Clarifies feature scope, including actions requiring desktop/web access and safety rules for task deletion and network exposure.\n- Includes quick-reference tables for commands, statuses, priorities, and agent/executor names.\n\nArchive index:\n\nArchive v0.1.0: 9 files, 19164 bytes\n\nFiles: examples.md (2119b), INSTALL.md (6383b), README.md (1056b), reference.md (6411b), scripts (0b), scripts/hk.sh (27186b), skill-card.md (2534b), SKILL.md (6783b), _meta.json (139b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: helios-kanban-remote\ndescription: >-\n  Remote control Helios Kanban (helios-kanban) via REST API — list/create/update\n  tasks, start/stop coding agents, follow-up, check status, handle approvals.\n  Use when the user wants to control kanban from phone/chat, mentions Helios\n  Kanban / helios-kanban / vibe-kanban remotely, or asks to create tasks, start\n  agents, or check progress on a running instance. If the skill is not installed\n  yet, read and follow INSTALL.md to self-install from GitHub first.\n---\n\n# Helios Kanban Remote Control\n\nControl a running [Helios Kanban](https://github.com/SolomonFang/vibe-kanban) instance over HTTP. Designed for chat bots (e.g. Hermes on phone) that can run shell commands or HTTP requests on a host with network access to the kanban server.\n\n## Prerequisites\n\n1. **Helios Kanban running** on a reachable host:\n   ```bash\n   HOST=0.0.0.0 PORT=7964 npx helios-kanban\n   ```\n2. **Network**: bot host can reach the server (Tailscale recommended).\n3. **Env vars** (set on the bot host):\n   - `HELIOS_KANBAN_URL` — base URL, e.g. `http://100.x.x.x:7964`\n   - `HELIOS_KANBAN_PROJECT_ID` — optional default project UUID\n   - `HELIOS_KANBAN_REPO_ID` — optional default repo UUID\n   - `HELIOS_KANBAN_ITERATION` — optional default iteration (e.g. `260717`)\n\n## Quick workflow\n\n| User intent | Action |\n|-------------|--------|\n| \"有哪些项目\" | `hk projects`（看 `description` + `repos` 选项目） |\n| \"创建项目\" | `hk projects create \"名称\" --repo-path /server/abs/path` |\n| \"默认 agent / 仓库\" | `hk info`；`hk repos` |\n| \"看看进行中的\" | `hk tasks list --status inprogress` |\n| \"找登录相关任务\" | `hk tasks list --query 登录` |\n| \"260717 迭代\" | `hk tasks list --iteration 260717` |\n| \"创建任务\" | `hk tasks create \"标题\" --desc \"用 @coding-standards\"` |\n| \"紧急任务\" | `hk tasks create \"标题\" --priority urgent` |\n| \"看紧急/高优任务\" | `hk tasks list --priority urgent` |\n| \"有哪些分支\" | `hk branches <repo_id> [--query develop]` |\n| \"多仓启动\" | `hk start <task_id> --repo <id1> --repo <id2>:develop` |\n| \"有哪些 tag\" | `hk tags` |\n| \"基于 develop 启动\" | `hk start <task_id> --branch develop` |\n| \"新建并启动\" | `hk create-and-start \"标题\"` |\n| \"再跟它说一句…\" | `hk follow-up <task_id> <prompt>`（运行中自动排队） |\n| \"跑得怎么样了\" | `hk status <task_id>` |\n| \"有没有待审批\" | `hk approvals` → `hk approve/deny … --process <ep_id>` |\n| \"停掉 agent\" | `hk workspaces --task <id>` → `hk stop <workspace_id>` |\n| \"取消任务\" | `hk tasks cancel <task_id>`（会先 stop） |\n| \"删除任务\" | 确认后 → `hk tasks delete <task_id>` |\n| \"标记完成\" | `hk tasks update <task_id> --status done` |\n\nCache `project_id` / `repo_id` in the conversation. Prefer env defaults so commands stay short.\n\n## Complete lifecycle\n\n```text\n1. hk repos / hk branches <repo>\n2. hk tasks create \"标题\" [--iteration CODE] [--priority P]\n3. hk start <task_id> [--branch B] [--repo R]\n     └─ or: hk create-and-start \"标题\" …\n4. hk status <task_id>                  # progress / diff summary\n5. hk follow-up <task_id> <prompt>      # continue chatting\n6. hk approvals → approve | deny\n7a. hk stop <workspace_id>\n7b. hk tasks cancel <task_id>\n7c. hk tasks delete <task_id>           # confirm first\n7d. hk tasks update --status done\n```\n\n### Defaults\n\n| Flag | When omitted |\n|------|----------------|\n| `--executor` | Settings → `config.executor_profile` via `hk info` |\n| `--branch` | `repo.default_target_branch`, else `main` |\n| `--repo` | `HELIOS_KANBAN_REPO_ID` |\n| `--iteration` | `HELIOS_KANBAN_ITERATION` |\n| `project_id` arg | `HELIOS_KANBAN_PROJECT_ID` |\n\n### cancel vs delete vs stop\n\n| Intent | Command | Effect |\n|--------|---------|--------|\n| 停 agent | `hk stop` | Kills agent; task remains |\n| 取消任务 | `hk tasks cancel` | Stops workspaces + status=`cancelled` |\n| 删除任务 | `hk tasks delete` | Permanent — **confirm first** |\n\n## Use the CLI\n\n```bash\nbash scripts/hk.sh <command> [args]\n```\n\nRequires `curl` and `jq`. See `scripts/hk.sh --help`.\n\n## Response format for chat\n\n```markdown\n**项目**: {name}\n**任务**: {title} (`{id}`)\n**迭代**: {iteration or —}\n**优先级**: {priority}\n**状态**: {status} | running: {yes/no} | failed: {yes/no}\n**分支**: {target_branch}\n**Executor**: {executor}\n**URL**: {url}\n**下一步**: {suggestion}\n```\n\n## Executor names (only when user names one)\n\n| User says | `--executor` |\n|-----------|--------------|\n| Claude / Claude Code | `CLAUDE_CODE` |\n| Codex | `CODEX` |\n| Gemini | `GEMINI` |\n| Amp | `AMP` |\n| Reasonix | `REASONIX` |\n| Cursor | `CURSOR_AGENT` |\n| Copilot | `COPILOT` |\n\n## Task statuses\n\n`todo` | `inprogress` | `inreview` | `done` | `cancelled`\n\n## Task priorities\n\n`urgent` | `high` | `medium` | `low` — default `medium` when omitted. Cards show a colored badge (red/orange/blue/gray).\n\n## Safety rules\n\n1. Confirm before `tasks delete` — prefer `cancel`.\n2. Prefer Tailscale; don’t expose kanban publicly without auth.\n3. Phone = dispatch / follow-up / approve — review diffs & merge on desktop.\n4. If `hk health` fails, stop and report connectivity.\n5. Multi-repo: repeat `--repo` (`ID` or `ID:branch`).\n6. PR / push / merge / rebase: tell user to use desktop Web UI.\n7. `@tagname` in `--desc` / follow-up expands via `hk tags` / `/api/tags`.\n\n## Out of scope (point user to Web UI)\n\n- Create/merge PR, push, rebase, conflict resolution\n- Full diff viewer / open in editor\n- Multi-repo workspace create\n\n## Not installed yet?\n\n**Read and execute [INSTALL.md](INSTALL.md) first.**\n\n```\n请阅读并执行安装文档：\nhttps://github.com/SolomonFang/vibe-kanban/blob/hly-dev/skills/helios-kanban-remote/INSTALL.md\n```\n\n## MCP (same machine) vs this skill (remote)\n\n- **Same host as the kanban server** → prefer the MCP server. It covers the full orchestration surface: project/task CRUD, `create_project`, `create_task_and_start`, `start/stop_workspace_session`, `follow_up_session`, `queue_message`, `get_task_status`, `list_approvals` / `respond_to_approval`, `list_branches`, `list_tags`.\n- **Remote (phone bot, another host)** → use `hk.sh` over HTTP, as this skill documents.\n- New capabilities land in the MCP server first; `hk.sh` mirrors them for remote use. If the two drift, the REST API in [reference.md](reference.md) is the source of truth.\n\n```json\n{\n  \"helios_kanban\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"helios-kanban@latest\", \"--mcp\"]\n  }\n}\n```\n\nMCP `start_workspace_session` / `create_task_and_start` may omit `executor` / `base_branch` (uses Settings + repo defaults).\n\n## More detail\n\n- API reference: [reference.md](reference.md)\n- Examples: [examples.md](examples.md)\n\nFile v0.1.0:README.md\n\n# Helios Kanban Skills\n\n> 这是一个用于 Helios 平台的看板（Kanban）技能/扩展模板（README 模板），包含项目概述、安装、使用示例和贡献说明。请根据你的仓库实际实现替换占位内容。\n\n## 项目简介\n\nHelios Kanban Skills 是一组用于在 Helios 平台上管理和展示看板（Kanban）相关功能的技能/工具集合。目标是提供直观的看板视图、任务卡片管理、列（lane）操作以及与后端同步的能力，便于在 Helios 环境中快速构建看板式工作流。\n\n> 注：这份 README 是通用模板。请根据仓库中实际的语言、运行方式和接口，替换下面的示例命令与配置示例。\n\n## 主要功能\n\n- 创建 / 编辑 / 删除 看板与列（lane）\n- 创建 / 编辑 / 移动 / 删除 任务卡片（card）\n- 支持多用户协作与权限控制（视实现而定）\n- 与 Helios 平台或自定义后端同步数据\n- 支持导入/导出（CSV/JSON）以及基本统计信息\n\n\n本项目采用 MIT 许可。详见 LICENSE 文件。\n\n---\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn7axrc2jv3ec02qw1y5wd160s8bke6s\",\n  \"slug\": \"helios-kanban-skills\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1785483409606\n}\n\nFile v0.1.0:examples.md\n\n# Examples\n\n## Setup\n\n```bash\nexport HELIOS_KANBAN_URL=\"http://100.64.0.5:7964\"\nexport HELIOS_KANBAN_PROJECT_ID=\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\nexport HELIOS_KANBAN_REPO_ID=\"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb\"\nexport HELIOS_KANBAN_ITERATION=\"260717\"\nHK=\"bash scripts/hk.sh\"\n```\n\n## Pick the right project\n\n```bash\n$HK projects\n# read description + repos, then:\nexport HELIOS_KANBAN_PROJECT_ID=\"<chosen>\"\n# or set description for agents:\n$HK projects update \"$HELIOS_KANBAN_PROJECT_ID\" --description \"Kanban product — UI/API work only\"\n```\n\n## Full remote loop\n\n**User**: 260717 新建「修复登录」，基于 develop 跑起来\n\n```bash\n$HK branches \"$HELIOS_KANBAN_REPO_ID\" --query develop\n$HK create-and-start \"修复登录\" --branch develop --desc \"登录页 500 @coding-standards\"\n# or multi-repo:\n# $HK start \"<task_id>\" --repo \"$REPO_A\" --repo \"$REPO_B:main\"\n```\n\n**User**: 怎么样了？\n\n```bash\n$HK status \"<task_id>\"\n# running, last_attempt_failed, workspace summaries (files/lines, pending approval)\n```\n\n**User**: 再跟它说加单测\n\n```bash\n$HK follow-up \"<task_id>\" 请补充单元测试并保持 API 兼容\n# mode=follow_up | queued\n```\n\n**User**: 有审批卡着\n\n```bash\n$HK approvals\n$HK approve \"<approval_id>\" --process \"<execution_process_id>\"\n# or: $HK deny \"<approval_id>\" --process \"<ep_id>\" --reason \"too risky\"\n```\n\n**User**: 停掉 / 取消\n\n```bash\n$HK workspaces --task \"<task_id>\"\n$HK stop \"<workspace_id>\"\n$HK tasks cancel \"<task_id>\"   # also stops workspaces\n```\n\n**User**: 找一下登录相关的 todo\n\n```bash\n$HK tasks list --status todo --query 登录\n```\n\n**User**: 建个紧急任务修线上 500，修完降到中\n\n```bash\n$HK tasks create \"修复线上 500\" --priority urgent\n$HK tasks list --priority urgent\n$HK tasks update \"<task_id>\" --priority medium\n```\n\n## curl snippets\n\n```bash\ncurl -s \"$HELIOS_KANBAN_URL/api/health\" | jq .\ncurl -s \"$HELIOS_KANBAN_URL/api/info\" | jq '.data.config.executor_profile'\ncurl -s \"$HELIOS_KANBAN_URL/api/approvals\" | jq '.data'\ncurl -s \"$HELIOS_KANBAN_URL/api/repos/$HELIOS_KANBAN_REPO_ID/branches\" | jq '.data[].name'\n```\n\nFile v0.1.0:INSTALL.md\n\n# Agent Self-Install Guide — Helios Kanban Remote Skill\n\n> **Audience**: AI agents (Cursor, Claude Code, Hermes, Codex, etc.)\n>\n> **Trigger**: User says \"安装 helios-kanban-remote 技能\", \"install helios kanban skill\", or gives you this repo / INSTALL.md URL.\n>\n> **Goal**: Clone this GitHub repo, install the skill, configure, and verify — **without human manual steps**. Execute every shell command yourself. Ask the user only when information is missing.\n\n---\n\n## Source (this repository)\n\n| Item | Value |\n|------|-------|\n| **Repository** | https://github.com/SolomonFang/vibe-kanban |\n| **Clone URL** | `https://github.com/SolomonFang/vibe-kanban.git` |\n| **Skill path** | `skills/helios-kanban-remote/` |\n| **Default branch** | `hly-dev` |\n| **This document** | https://github.com/SolomonFang/vibe-kanban/blob/hly-dev/skills/helios-kanban-remote/INSTALL.md |\n\nThe skill is published **inside this repo**. Do not look for a separate package — clone or use this repository directly.\n\n---\n\n## Agent instructions — follow in order\n\n```\nInstall progress:\n- [ ] Step 1: Detect environment\n- [ ] Step 2: Get skill files from this repo\n- [ ] Step 3: Install to agent skills directory\n- [ ] Step 4: Check dependencies (curl, jq)\n- [ ] Step 5: Configure HELIOS_KANBAN_URL\n- [ ] Step 6: Verify connectivity\n- [ ] Step 7: Report result to user\n```\n\n---\n\n### Step 1: Detect environment\n\n```bash\nuname -s\necho \"HOME=$HOME\"\npwd\n```\n\nDetermine agent type and `SKILLS_ROOT`:\n\n| Agent | `SKILLS_ROOT` |\n|-------|---------------|\n| Cursor (global) | `$HOME/.cursor/skills` |\n| Claude Code | `$HOME/.claude/skills` |\n| Cursor (project) | `<workspace>/.cursor/skills` |\n| Hermes / other | user-provided, or `$HOME/.cursor/skills` |\n\n```bash\nSKILLS_ROOT=\"$HOME/.cursor/skills\"   # adjust per table\nSKILL_DIR=\"$SKILLS_ROOT/helios-kanban-remote\"\nREPO_URL=\"https://github.com/SolomonFang/vibe-kanban.git\"\nBRANCH=\"hly-dev\"\nREPO_DIR=\"\"   # set in Step 2\n```\n\n**Do not** install into `~/.cursor/skills-cursor/` (reserved by Cursor).\n\n---\n\n### Step 2: Get skill files from this repo\n\n**Option A — already inside this repository** (e.g. workspace is `vibe-kanban`):\n\n```bash\nREPO_DIR=\"$(git rev-parse --show-toplevel 2>/dev/null || pwd)\"\ntest -f \"$REPO_DIR/skills/helios-kanban-remote/SKILL.md\" || {\n  echo \"error: skill not found in current repo\"; exit 1\n}\necho \"Using local repo: $REPO_DIR\"\n```\n\n**Option B — not in repo, clone from GitHub** (default):\n\n```bash\nREPO_DIR=\"${TMPDIR:-/tmp}/vibe-kanban\"\nrm -rf \"$REPO_DIR\"\ngit clone --depth 1 -b \"$BRANCH\" \"$REPO_URL\" \"$REPO_DIR\"\ntest -f \"$REPO_DIR/skills/helios-kanban-remote/SKILL.md\" || {\n  echo \"error: clone succeeded but skill path missing\"; exit 1\n}\necho \"Cloned repo to: $REPO_DIR\"\n```\n\n---\n\n### Step 3: Install to agent skills directory\n\n```bash\nmkdir -p \"$SKILLS_ROOT\"\nrm -rf \"$SKILL_DIR\"\ncp -r \"$REPO_DIR/skills/helios-kanban-remote\" \"$SKILL_DIR\"\nchmod +x \"$SKILL_DIR/scripts/hk.sh\"\nHK=\"$SKILL_DIR/scripts/hk.sh\"\n\n# Verify\ntest -f \"$SKILL_DIR/SKILL.md\" && test -f \"$HK\" && echo \"OK: installed to $SKILL_DIR\"\n```\n\n---\n\n### Step 4: Check dependencies\n\n```bash\ncommand -v curl >/dev/null || { echo \"MISSING: curl\"; exit 1; }\ncommand -v jq   >/dev/null || { echo \"MISSING: jq\"; exit 1; }\n```\n\nIf `jq` is missing, install when possible:\n\n```bash\n# macOS\nbrew install jq\n\n# Debian/Ubuntu\nsudo apt-get update && sudo apt-get install -y jq\n```\n\n---\n\n### Step 5: Configure environment variables\n\n**Required**: `HELIOS_KANBAN_URL` — URL of the running Helios Kanban instance.\n\n1. Use existing env var if already set.\n2. Otherwise **ask the user once**: \"请提供 Helios Kanban 地址，例如 `http://100.x.x.x:7964`\"\n3. Optional defaults (ask if user wants shortcuts):\n   - `HELIOS_KANBAN_PROJECT_ID` — default project UUID\n   - `HELIOS_KANBAN_REPO_ID` — default repo UUID\n   - `HELIOS_KANBAN_ITERATION` — default iteration code (e.g. `260717`)\n\n```bash\nexport HELIOS_KANBAN_URL=\"<user-provided-url>\"\n# export HELIOS_KANBAN_PROJECT_ID=\"<uuid>\"\n# export HELIOS_KANBAN_REPO_ID=\"<uuid>\"\n# export HELIOS_KANBAN_ITERATION=\"260717\"\n```\n\nPersist (skip if already in profile):\n\n```bash\nPROFILE=\"$HOME/.zshrc\"\n[ -f \"$HOME/.bashrc\" ] && PROFILE=\"$HOME/.bashrc\"\ngrep -q 'HELIOS_KANBAN_URL' \"$PROFILE\" 2>/dev/null || \\\n  echo \"export HELIOS_KANBAN_URL=\\\"$HELIOS_KANBAN_URL\\\"\" >> \"$PROFILE\"\n```\n\nKanban server (separate host) must be running:\n\n```bash\nHOST=0.0.0.0 PORT=7964 npx helios-kanban\n```\n\n---\n\n### Step 6: Verify connectivity\n\n```bash\nbash \"$HK\" health\nbash \"$HK\" projects\n```\n\nSuccess: `health` returns `\"success\": true`; `projects` returns a JSON array.\n\nIf failed → check URL, kanban process, network (Tailscale). Do not claim install succeeded.\n\n---\n\n### Step 7: Report result to user\n\n```markdown\n## Helios Kanban Remote 技能已安装\n\n- **来源仓库**: https://github.com/SolomonFang/vibe-kanban\n- **安装路径**: `{SKILL_DIR}`\n- **CLI**: `{SKILL_DIR}/scripts/hk.sh`\n- **Kanban 地址**: `{HELIOS_KANBAN_URL}`\n- **连通性**: 正常\n\n你现在可以对我说：\n- 「有哪些项目」\n- 「看看进行中的任务」\n- 「创建一个任务：……」\n- 「用 Claude 跑这个任务」\n```\n\n---\n\n## User gives agent only a URL\n\nTell any agent:\n\n```\n请阅读并执行安装文档，完成 helios-kanban-remote 技能安装：\nhttps://github.com/SolomonFang/vibe-kanban/blob/hly-dev/skills/helios-kanban-remote/INSTALL.md\n```\n\nOr shorter:\n\n```\n安装 Helios Kanban 远程控制技能：https://github.com/SolomonFang/vibe-kanban\n```\n\nAgent should fetch INSTALL.md from the repo, then run Steps 1–7.\n\nRaw URL for fetching:\n\n```\nhttps://raw.githubusercontent.com/SolomonFang/vibe-kanban/hly-dev/skills/helios-kanban-remote/INSTALL.md\n```\n\n---\n\n## Update\n\n```bash\ncd \"$REPO_DIR\" && git pull origin hly-dev   # if local clone exists\n# or re-clone (Step 2 Option B) and re-copy (Step 3)\n```\n\n---\n\n## Uninstall\n\n```bash\nrm -rf \"$SKILL_DIR\"\n```\n\n---\n\n## Troubleshooting\n\n| Symptom | Action |\n|---------|--------|\n| `git clone` fails | Check network and repo URL |\n| `health` connection refused | Kanban not running or wrong `HELIOS_KANBAN_URL` |\n| API 403 | Set `VK_ALLOWED_ORIGINS` on kanban server (reverse proxy) |\n| Skill not loading | Confirm `$SKILL_DIR/SKILL.md` exists; restart agent session |\n\n---\n\n## After install\n\nRead `$SKILL_DIR/SKILL.md` for usage. API details in `reference.md`, examples in `examples.md`.\n\nFile v0.1.0:reference.md\n\n# Helios Kanban REST API Reference\n\nBase URL: `$HELIOS_KANBAN_URL` (no trailing slash). All paths under `/api`.\n\nResponse envelope:\n\n```json\n{ \"success\": true, \"data\": { ... }, \"message\": null, \"error_data\": null }\n```\n\nRead `.data` on success; read `.message` on failure.\n\n## Endpoints\n\n| Method | Path | Purpose |\n|--------|------|---------|\n| GET | `/health` | Liveness check |\n| GET | `/info` | Server/user config (includes default `executor_profile`) |\n| GET | `/projects` | List projects (`description`, repos via separate call) |\n| POST | `/projects` | Create project |\n| GET | `/projects/{project_id}` | Get project |\n| PUT | `/projects/{project_id}` | Update project (`name`, `description`) |\n| GET | `/projects/{project_id}/repositories` | List repos |\n| GET | `/repos/{repo_id}` | Repo details (`default_target_branch`) |\n| GET | `/repos/{repo_id}/branches` | List branches |\n| GET | `/tasks?project_id={uuid}` | List tasks |\n| POST | `/tasks` | Create task |\n| GET | `/tasks/{task_id}` | Get task |\n| PUT | `/tasks/{task_id}` | Update task |\n| DELETE | `/tasks/{task_id}` | Delete task |\n| POST | `/tasks/create-and-start` | Create task + start agent |\n| POST | `/task-attempts` | Start agent on existing task |\n| GET | `/task-attempts?task_id={uuid}` | List workspaces for task |\n| POST | `/task-attempts/summary` | Workspace summaries (diff/approvals) |\n| POST | `/task-attempts/{workspace_id}/stop` | Stop running agent |\n| GET | `/sessions?workspace_id={uuid}` | List sessions |\n| POST | `/sessions/{session_id}/follow-up` | Send follow-up prompt |\n| POST | `/sessions/{session_id}/queue` | Queue follow-up while running |\n| GET | `/approvals` | List pending approvals |\n| POST | `/approvals/{id}/respond` | Approve / deny |\n\n## Default executor profile\n\n```bash\nhk info | jq '.config.executor_profile'\n```\n\n## Create project\n\n```json\nPOST /api/projects\n{\n  \"name\": \"My project\",\n  \"description\": \"What this project is for\",\n  \"repositories\": [\n    { \"display_name\": \"my-repo\", \"git_repo_path\": \"/abs/path/on/server\" }\n  ]\n}\n```\n\n`git_repo_path` is a path on the kanban **server** host, not the bot host. `repositories` may be empty.\n\n```bash\nhk projects create \"My project\" --repo-path /abs/path/on/server\n```\n\n## Project description (for agents)\n\nProjects may include a human/agent-facing `description`. Use it (with linked repo names) to choose `project_id` before creating tasks.\n\n```bash\nhk projects\nhk projects update <project_id> --description \"Helios Kanban app — create tasks here for UI/API work\"\n```\n\n```json\nPUT /api/projects/{project_id}\n{ \"description\": \"What this project is for\" }\n```\n\nPass `\"\"` to clear. Omit the field to keep the existing value.\n\n```json\nGET /api/info\n{\n  \"config\": {\n    \"executor_profile\": {\n      \"executor\": \"CODEX\",\n      \"variant\": \"DEFAULT\"\n    }\n  }\n}\n```\n\nUse this when starting an agent unless the user names a specific executor. Fresh installs default to `CLAUDE_CODE` until changed in Settings → Agents.\n\n## Create task\n\n```json\nPOST /api/tasks\n{\n  \"project_id\": \"uuid\",\n  \"title\": \"Fix login bug\",\n  \"description\": \"Optional details\",\n  \"status\": \"todo\",\n  \"priority\": \"high\",\n  \"iteration\": \"260717\"\n}\n```\n\n`priority` is optional: `urgent` | `high` | `medium` | `low` (default `medium`).\n\n## Update task\n\n```json\nPUT /api/tasks/{task_id}\n{\n  \"status\": \"inprogress\",\n  \"priority\": \"urgent\",\n  \"title\": \"New title\",\n  \"description\": \"Updated desc\",\n  \"iteration\": \"260717\"\n}\n```\n\n## Start agent (existing task)\n\n```json\nPOST /api/task-attempts\n{\n  \"task_id\": \"uuid\",\n  \"executor_profile_id\": {\n    \"executor\": \"CODEX\",\n    \"variant\": \"DEFAULT\"\n  },\n  \"repos\": [\n    { \"repo_id\": \"uuid\", \"target_branch\": \"main\" }\n  ]\n}\n```\n\nPrefer reading `executor` / `variant` from `GET /api/info` → `config.executor_profile` rather than hardcoding.\n\n`target_branch` is the base branch. Prefer `GET /api/repos/{repo_id}` → `default_target_branch` when the user does not name a branch.\n\n## Create and start (one shot)\n\n```json\nPOST /api/tasks/create-and-start\n{\n  \"task\": {\n    \"project_id\": \"uuid\",\n    \"title\": \"Fix login bug\",\n    \"description\": \"...\",\n    \"priority\": \"high\",\n    \"iteration\": \"260717\"\n  },\n  \"executor_profile_id\": {\n    \"executor\": \"CODEX\",\n    \"variant\": null\n  },\n  \"repos\": [\n    { \"repo_id\": \"uuid\", \"target_branch\": \"develop\" }\n  ]\n}\n```\n\n## Cancel vs delete vs stop\n\n| Action | Method | Path / CLI |\n|--------|--------|------------|\n| Soft cancel | `PUT` | `/tasks/{id}` `{ \"status\": \"cancelled\" }` → `hk tasks cancel` |\n| Hard delete | `DELETE` | `/tasks/{id}` → `hk tasks delete` (confirm first) |\n| Stop agent | `POST` | `/task-attempts/{workspace_id}/stop` → `hk stop` |\n\n## Follow-up\n\n```json\nPOST /api/sessions/{session_id}/follow-up\n{\n  \"prompt\": \"请补充单元测试\",\n  \"executor_profile_id\": { \"executor\": \"CODEX\", \"variant\": null }\n}\n```\n\nIf the agent is already running, queue instead:\n\n```json\nPOST /api/sessions/{session_id}/queue\n{\n  \"message\": \"请补充单元测试\",\n  \"executor_profile_id\": { \"executor\": \"CODEX\" }\n}\n```\n\n`hk follow-up` picks queue vs follow-up automatically.\n\n## Approvals\n\n```json\nGET /api/approvals\n→ [{ \"approval_id\", \"tool_name\", \"execution_process_id\", \"is_question\", ... }]\n\nPOST /api/approvals/{approval_id}/respond\n{\n  \"execution_process_id\": \"uuid\",\n  \"status\": { \"status\": \"approved\" }\n}\n```\n\nDeny: `{ \"status\": \"denied\", \"reason\": \"optional\" }`. Question-type approvals (`is_question: true`) need the Web UI for structured answers.\n\n## Status / summary\n\n```json\nPOST /api/task-attempts/summary\n{ \"archived\": false }\n```\n\nReturns per-workspace diff stats, `has_pending_approval`, latest process status. `hk status <task_id>` composes task + workspaces + matching summaries.\n\n## Tags (`@tagname`)\n\n`GET /api/tags` returns `{ id, tag_name, content }`.\n\nIn `hk tasks create/update --desc` and `hk follow-up`, `@tagname` is expanded to the tag content (same as MCP).\n\n```bash\nhk tags\nhk tasks create \"Fix\" --desc \"Follow @coding-standards\"\n```\n\n## Executors (from default_profiles.json)\n\n`CLAUDE_CODE`, `AMP`, `GEMINI`, `CODEX`, `COPILOT`, `REASONIX`, `CURSOR_AGENT`, `QWEN_CODE`, `OPENCODE`, `ECHO`, and others.\n\nCommon variants: `DEFAULT`, `PLAN`, `OPUS`, `APPROVALS`, `FLASH`, `PRO`, `HIGH`, `MAX`.\n\n## Origin header\n\nIf accessing via a custom domain behind reverse proxy, server must have `VK_ALLOWED_ORIGINS` set. Direct IP/Tailscale access typically works without it.\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nRemote control Helios Kanban via REST API to list, create, and update tasks; start or stop coding agents; send follow-ups; check status; and handle approvals.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[solomonfang](https://clawhub.ai/user/solomonfang)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and engineering teams use this skill to operate a running Helios Kanban instance from an agent or chat host: manage projects and tasks, launch coding agents on selected repositories and branches, follow up on sessions, review status, and respond to approvals.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can create, update, cancel, and delete tasks; start and stop coding agents; and approve or deny execution processes on a reachable Helios Kanban server.\n\nMitigation: Install only for trusted Helios Kanban servers, keep the server behind an authenticated private network, and manually confirm deletes and approvals before execution.\n\nRisk: The install flow includes cloning from a repository and running package-manager or system-install commands such as npx, brew, apt-get, and sudo.\n\nMitigation: Pin repository commits or package versions before installation and avoid running sudo, npx, or package installation commands automatically.\n\nRisk: Tag content may be expanded into task descriptions or follow-up prompts before being sent to a coding agent.\n\nMitigation: Treat tag content as untrusted and review expanded prompts before sending them to an agent.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/solomonfang/skills/helios-kanban-skills)\n- [Server-resolved source repository](https://github.com/SolomonFang/helios-kanban-skills)\n- [Helios Kanban REST API Reference](reference.md)\n- [Examples](examples.md)\n- [Installation Guide](INSTALL.md)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, API Calls, Markdown, Configuration instructions, Guidance]\n\n**Output Format:** [Markdown with inline bash commands and JSON snippets]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May return JSON from hk.sh and concise Markdown status summaries.]\n\n## Skill Version(s):\n\n0.1.0 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.","readmeExcerpt":"Skill: Helios Kanban Remote Owner: solomonfang Summary: Remote control Helios Kanban (helios-kanban) via REST API — list/create/update tasks, start/stop coding agents, follow-up, check status, handle approvals. Use when the user wants to control kanban from phone/chat, mentions Helios Kanban / helios-kanban / vibe-kanban remotely, or asks to create tasks, start agents, or check progress on a running instance. If the ","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"HOST=0.0.0.0 PORT=7964 npx helios-kanban"},{"language":"text","snippet":"1. hk repos / hk branches <repo>\n2. hk tasks create \"标题\" [--iteration CODE] [--priority P]\n3. hk start <task_id> [--branch B] [--repo R]\n     └─ or: hk create-and-start \"标题\" …\n4. hk status <task_id>                  # progress / diff summary\n5. hk follow-up <task_id> <prompt>      # continue chatting\n6. hk approvals → approve | deny\n7a. hk stop <workspace_id>\n7b. hk tasks cancel <task_id>\n7c. hk tasks delete <task_id>           # confirm first\n7d. hk tasks update --status done"},{"language":"bash","snippet":"bash scripts/hk.sh <command> [args]"},{"language":"markdown","snippet":"**项目**: {name}\n**任务**: {title} (`{id}`)\n**迭代**: {iteration or —}\n**优先级**: {priority}\n**状态**: {status} | running: {yes/no} | failed: {yes/no}\n**分支**: {target_branch}\n**Executor**: {executor}\n**URL**: {url}\n**下一步**: {suggestion}"},{"language":"text","snippet":"请阅读并执行安装文档：\nhttps://github.com/SolomonFang/vibe-kanban/blob/hly-dev/skills/helios-kanban-remote/INSTALL.md"},{"language":"json","snippet":"{\n  \"helios_kanban\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"helios-kanban@latest\", \"--mcp\"]\n  }\n}"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: helios-kanban-remote\ndescription: >-\n  Remote control Helios Kanban (helios-kanban) via REST API — list/create/update\n  tasks, start/stop coding agents, follow-up, check status, handle approvals.\n  Use when the user wants to control kanban from phone/chat, mentions Helios\n  Kanban / helios-kanban / vibe-kanban remotely, or asks to create tasks, start\n  agents, or check progress on a running instance. If the skill is not installed\n  yet, read and follow INSTALL.md to self-install from GitHub first.\n---\n\n# Helios Kanban Remote Control\n\nControl a running [Helios Kanban](https://github.com/SolomonFang/vibe-kanban) instance over HTTP. Designed for chat bots (e.g. Hermes on phone) that can run shell commands or HTTP requests on a host with network access to the kanban server.\n\n## Prerequisites\n\n1. **Helios Kanban running** on a reachable host:\n   ```bash\n   HOST=0.0.0.0 PORT=7964 npx helios-kanban\n   ```\n2. **Network**: bot host can reach the server (Tailscale recommended).\n3. **Env vars** (set on the bot host):\n   - `HELIOS_KANBAN_URL` — base URL, e.g. `http://100.x.x.x:7964`\n   - `HELIOS_KANBAN_PROJECT_ID` — optional default project UUID\n   - `HELIOS_KANBAN_REPO_ID` — optional default repo UUID\n   - `HELIOS_KANBAN_ITERATION` — optional default iteration (e.g. `260717`)\n\n## Quick workflow\n\n| User intent | Action |\n|-------------|--------|\n| \"有哪些项目\" | `hk projects`（看 `description` + `repos` 选项目） |\n| \"创建项目\" | `hk projects create \"名称\" --repo-path /server/abs/path` |\n| \"默认 agent / 仓库\" | `hk info`；`hk repos` |\n| \"看看进行中的\" | `hk tasks list --status inprogress` |\n| \"找登录相关任务\" | `hk tasks list --query 登录` |\n| \"260717 迭代\" | `hk tasks list --iteration 260717` |\n| \"创建任务\" | `hk tasks create \"标题\" --desc \"用 @coding-standards\"` |\n| \"紧急任务\" | `hk tasks create \"标题\" --priority urgent` |\n| \"看紧急/高优任务\" | `hk tasks list --priority urgent` |\n| \"有哪些分支\" | `hk branches <repo_id> [--query develop]` |\n| \"多仓启动\" | `hk start <task_id> --repo <id1> --repo <id2>:develop` |\n| \"有哪些 tag\" | `hk tags` |\n| \"基于 develop 启动\" | `hk start <task_id> --branch develop` |\n| \"新建并启动\" | `hk create-and-start \"标题\"` |\n| \"再跟它说一句…\" | `hk follow-up <task_id> <prompt>`（运行中自动排队） |\n| \"跑得怎么样了\" | `hk status <task_id>` |\n| \"有没有待审批\" | `hk approvals` → `hk approve/deny … --process <ep_id>` |\n| \"停掉 agent\" | `hk workspaces --task <id>` → `hk stop <workspace_id>` |\n| \"取消任务\" | `hk tasks cancel <task_id>`（会先 stop） |\n| \"删除任务\" | 确认后 → `hk tasks delete <task_id>` |\n| \"标记完成\" | `hk tasks update <task_id> --status done` |\n\nCache `project_id` / `repo_id` in the conversation. Prefer env defaults so commands stay short.\n\n## Complete lifecycle\n\n```text\n1. hk repos / hk branches <repo>\n2. hk tasks create \"标题\" [--iteration CODE] [--priority P]\n3. hk start <task_id> [--branch B] [--repo R]\n     └─ or: hk create-and-start \"标题\" …\n4. hk status <task_id>                  # progress / diff summary\n5. hk follow-up <task_id> <prompt>      # continue chatting\n6. hk approvals → approve | deny\n7a. hk stop <workspace_id>\n7b. hk tasks ca"},{"path":"README.md","content":"# Helios Kanban Skills\n\n> 这是一个用于 Helios 平台的看板（Kanban）技能/扩展模板（README 模板），包含项目概述、安装、使用示例和贡献说明。请根据你的仓库实际实现替换占位内容。\n\n## 项目简介\n\nHelios Kanban Skills 是一组用于在 Helios 平台上管理和展示看板（Kanban）相关功能的技能/工具集合。目标是提供直观的看板视图、任务卡片管理、列（lane）操作以及与后端同步的能力，便于在 Helios 环境中快速构建看板式工作流。\n\n> 注：这份 README 是通用模板。请根据仓库中实际的语言、运行方式和接口，替换下面的示例命令与配置示例。\n\n## 主要功能\n\n- 创建 / 编辑 / 删除 看板与列（lane）\n- 创建 / 编辑 / 移动 / 删除 任务卡片（card）\n- 支持多用户协作与权限控制（视实现而定）\n- 与 Helios 平台或自定义后端同步数据\n- 支持导入/导出（CSV/JSON）以及基本统计信息\n\n\n本项目采用 MIT 许可。详见 LICENSE 文件。\n\n---"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7axrc2jv3ec02qw1y5wd160s8bke6s\",\n  \"slug\": \"helios-kanban-skills\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1785483409606\n}"},{"path":"examples.md","content":"# Examples\n\n## Setup\n\n```bash\nexport HELIOS_KANBAN_URL=\"http://100.64.0.5:7964\"\nexport HELIOS_KANBAN_PROJECT_ID=\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\nexport HELIOS_KANBAN_REPO_ID=\"bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb\"\nexport HELIOS_KANBAN_ITERATION=\"260717\"\nHK=\"bash scripts/hk.sh\"\n```\n\n## Pick the right project\n\n```bash\n$HK projects\n# read description + repos, then:\nexport HELIOS_KANBAN_PROJECT_ID=\"<chosen>\"\n# or set description for agents:\n$HK projects update \"$HELIOS_KANBAN_PROJECT_ID\" --description \"Kanban product — UI/API work only\"\n```\n\n## Full remote loop\n\n**User**: 260717 新建「修复登录」，基于 develop 跑起来\n\n```bash\n$HK branches \"$HELIOS_KANBAN_REPO_ID\" --query develop\n$HK create-and-start \"修复登录\" --branch develop --desc \"登录页 500 @coding-standards\"\n# or multi-repo:\n# $HK start \"<task_id>\" --repo \"$REPO_A\" --repo \"$REPO_B:main\"\n```\n\n**User**: 怎么样了？\n\n```bash\n$HK status \"<task_id>\"\n# running, last_attempt_failed, workspace summaries (files/lines, pending approval)\n```\n\n**User**: 再跟它说加单测\n\n```bash\n$HK follow-up \"<task_id>\" 请补充单元测试并保持 API 兼容\n# mode=follow_up | queued\n```\n\n**User**: 有审批卡着\n\n```bash\n$HK approvals\n$HK approve \"<approval_id>\" --process \"<execution_process_id>\"\n# or: $HK deny \"<approval_id>\" --process \"<ep_id>\" --reason \"too risky\"\n```\n\n**User**: 停掉 / 取消\n\n```bash\n$HK workspaces --task \"<task_id>\"\n$HK stop \"<workspace_id>\"\n$HK tasks cancel \"<task_id>\"   # also stops workspaces\n```\n\n**User**: 找一下登录相关的 todo\n\n```bash\n$HK tasks list --status todo --query 登录\n```\n\n**User**: 建个紧急任务修线上 500，修完降到中\n\n```bash\n$HK tasks create \"修复线上 500\" --priority urgent\n$HK tasks list --priority urgent\n$HK tasks update \"<task_id>\" --priority medium\n```\n\n## curl snippets\n\n```bash\ncurl -s \"$HELIOS_KANBAN_URL/api/health\" | jq .\ncurl -s \"$HELIOS_KANBAN_URL/api/info\" | jq '.data.config.executor_profile'\ncurl -s \"$HELIOS_KANBAN_URL/api/approvals\" | jq '.data'\ncurl -s \"$HELIOS_KANBAN_URL/api/repos/$HELIOS_KANBAN_REPO_ID/branches\" | jq '.data[].name'\n```"},{"path":"INSTALL.md","content":"# Agent Self-Install Guide — Helios Kanban Remote Skill\n\n> **Audience**: AI agents (Cursor, Claude Code, Hermes, Codex, etc.)\n>\n> **Trigger**: User says \"安装 helios-kanban-remote 技能\", \"install helios kanban skill\", or gives you this repo / INSTALL.md URL.\n>\n> **Goal**: Clone this GitHub repo, install the skill, configure, and verify — **without human manual steps**. Execute every shell command yourself. Ask the user only when information is missing.\n\n---\n\n## Source (this repository)\n\n| Item | Value |\n|------|-------|\n| **Repository** | https://github.com/SolomonFang/vibe-kanban |\n| **Clone URL** | `https://github.com/SolomonFang/vibe-kanban.git` |\n| **Skill path** | `skills/helios-kanban-remote/` |\n| **Default branch** | `hly-dev` |\n| **This document** | https://github.com/SolomonFang/vibe-kanban/blob/hly-dev/skills/helios-kanban-remote/INSTALL.md |\n\nThe skill is published **inside this repo**. Do not look for a separate package — clone or use this repository directly.\n\n---\n\n## Agent instructions — follow in order\n\n```\nInstall progress:\n- [ ] Step 1: Detect environment\n- [ ] Step 2: Get skill files from this repo\n- [ ] Step 3: Install to agent skills directory\n- [ ] Step 4: Check dependencies (curl, jq)\n- [ ] Step 5: Configure HELIOS_KANBAN_URL\n- [ ] Step 6: Verify connectivity\n- [ ] Step 7: Report result to user\n```\n\n---\n\n### Step 1: Detect environment\n\n```bash\nuname -s\necho \"HOME=$HOME\"\npwd\n```\n\nDetermine agent type and `SKILLS_ROOT`:\n\n| Agent | `SKILLS_ROOT` |\n|-------|---------------|\n| Cursor (global) | `$HOME/.cursor/skills` |\n| Claude Code | `$HOME/.claude/skills` |\n| Cursor (project) | `<workspace>/.cursor/skills` |\n| Hermes / other | user-provided, or `$HOME/.cursor/skills` |\n\n```bash\nSKILLS_ROOT=\"$HOME/.cursor/skills\"   # adjust per table\nSKILL_DIR=\"$SKILLS_ROOT/helios-kanban-remote\"\nREPO_URL=\"https://github.com/SolomonFang/vibe-kanban.git\"\nBRANCH=\"hly-dev\"\nREPO_DIR=\"\"   # set in Step 2\n```\n\n**Do not** install into `~/.cursor/skills-cursor/` (reserved by Cursor).\n\n---\n\n### Step 2: Get skill files from this repo\n\n**Option A — already inside this repository** (e.g. workspace is `vibe-kanban`):\n\n```bash\nREPO_DIR=\"$(git rev-parse --show-toplevel 2>/dev/null || pwd)\"\ntest -f \"$REPO_DIR/skills/helios-kanban-remote/SKILL.md\" || {\n  echo \"error: skill not found in current repo\"; exit 1\n}\necho \"Using local repo: $REPO_DIR\"\n```\n\n**Option B — not in repo, clone from GitHub** (default):\n\n```bash\nREPO_DIR=\"${TMPDIR:-/tmp}/vibe-kanban\"\nrm -rf \"$REPO_DIR\"\ngit clone --depth 1 -b \"$BRANCH\" \"$REPO_URL\" \"$REPO_DIR\"\ntest -f \"$REPO_DIR/skills/helios-kanban-remote/SKILL.md\" || {\n  echo \"error: clone succeeded but skill path missing\"; exit 1\n}\necho \"Cloned repo to: $REPO_DIR\"\n```\n\n---\n\n### Step 3: Install to agent skills directory\n\n```bash\nmkdir -p \"$SKILLS_ROOT\"\nrm -rf \"$SKILL_DIR\"\ncp -r \"$REPO_DIR/skills/helios-kanban-remote\" \"$SKILL_DIR\"\nchmod +x \"$SKILL_DIR/scripts/hk.sh\"\nHK=\"$SKILL_DIR/scripts/hk.sh\"\n\n# Verify\ntest -f \"$SKILL_DIR/SKILL.md\" && test -f \"$HK"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1274,"uniquenessScore":39,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T12:11:38.926Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T12:11:38.926Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T05:25:03.184Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}