{"id":"b4451056-3a9b-4293-905f-041f2b51332b","shortId":"uzxpuA","kind":"skill","title":"manage-delegates","tagline":">-","description":"# Manage Delegates\n\nMonitor delegate health and manage registration tokens via MCP.\n\n## Instructions\n\n### Step 1: List Delegates\n\nList all delegates in the account to check health and connectivity:\n\n```\nCall MCP tool: harness_list\nParameters:\n  resource_type: \"delegate\"\n```\n\nThis returns all delegates with their status, version, connectivity, and last heartbeat. Delegates are account-scoped -- no org/project needed.\n\n### Step 2: List Delegate Tokens\n\n```\nCall MCP tool: harness_list\nParameters:\n  resource_type: \"delegate_token\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n```\n\nFilter by name or status:\n\n```\nCall MCP tool: harness_list\nParameters:\n  resource_type: \"delegate_token\"\n  name: \"prod-token\"\n  status: \"ACTIVE\"\n```\n\n### Step 3: Get Token Details\n\n```\nCall MCP tool: harness_get\nParameters:\n  resource_type: \"delegate_token\"\n  resource_id: \"<token_name>\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n```\n\n### Step 4: Create a Token\n\n```\nCall MCP tool: harness_create\nParameters:\n  resource_type: \"delegate_token\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n  body:\n    name: \"prod-delegate-token\"\n```\n\n### Step 5: Find Delegates for a Token\n\n```\nCall MCP tool: harness_execute\nParameters:\n  resource_type: \"delegate_token\"\n  action: \"get_delegates\"\n  resource_id: \"<token_name>\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n```\n\n### Step 6: Revoke a Token\n\n```\nCall MCP tool: harness_execute\nParameters:\n  resource_type: \"delegate_token\"\n  action: \"revoke\"\n  resource_id: \"<token_name>\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n```\n\n### Step 7: Delete a Token\n\n```\nCall MCP tool: harness_delete\nParameters:\n  resource_type: \"delegate_token\"\n  resource_id: \"<token_name>\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n```\n\n## Resource Types\n\n| Resource Type | Scope | Operations | Description |\n|--------------|-------|-----------|-------------|\n| `delegate` | Account | list | List delegates with health status |\n| `delegate_token` | Project | list, get, create, delete + revoke, get_delegates actions | Manage registration tokens |\n\n## Examples\n\n- \"Are all delegates healthy?\" -- List delegates, check status and last heartbeat\n- \"Create a new delegate token for the staging project\" -- Create token with project scope\n- \"Which delegates are using the prod-token?\" -- Execute get_delegates action on the token\n- \"Revoke the old registration token\" -- Execute revoke action\n- \"Show me all active delegate tokens\" -- List tokens filtered by status ACTIVE\n\n## Performance Notes\n\n- When diagnosing delegate issues, check both the delegate list (for health/heartbeat) and the token status (for auth). A delegate showing as disconnected may have a revoked token.\n- Always verify delegate connectivity before troubleshooting pipeline failures -- many execution errors stem from unavailable delegates.\n\n## Troubleshooting\n\n### Delegate Shows Disconnected\n1. Check the delegate's last heartbeat timestamp -- if stale, the delegate process may be down\n2. Verify the delegate token is ACTIVE (not REVOKED)\n3. Check network connectivity between the delegate host and Harness SaaS\n\n### Pipeline Fails with \"No Delegates Available\"\n1. List delegates to confirm at least one is connected and healthy\n2. Check if the pipeline uses a delegate selector that doesn't match any active delegate\n3. Verify the delegate has the required tools installed (kubectl, helm, docker, etc.)\n\n### Token Issues\n- Tokens are project-scoped -- a token created in project A cannot register delegates for project B\n- Revoking a token disconnects all delegates registered with it\n- Deleted tokens cannot be recovered -- create a new one and re-register delegates","tags":["manage","delegates","harness","skills","agent-skills","agents"],"capabilities":["skill","source-harness","skill-manage-delegates","topic-agent-skills","topic-agents"],"categories":["harness-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/harness/harness-skills/manage-delegates","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add harness/harness-skills","source_repo":"https://github.com/harness/harness-skills","install_from":"skills.sh"}},"qualityScore":"0.457","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 15 github stars · SKILL.md body (3,693 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:06:30.296Z","embedding":null,"createdAt":"2026-05-09T01:05:28.977Z","updatedAt":"2026-05-18T19:06:30.296Z","lastSeenAt":"2026-05-18T19:06:30.296Z","tsv":"'1':17,354,396 '2':61,370,408 '3':101,379,424 '4':122 '5':147 '6':173 '7':196 'account':25,55,224 'account-scop':54 'action':163,187,241,282,293 'activ':99,297,305,376,422 'alway':335 'auth':324 'avail':395 'b':455 'bodi':140 'call':31,65,84,105,126,153,177,200 'cannot':450,467 'check':27,252,312,355,380,409 'confirm':400 'connect':30,48,338,382,405 'creat':123,130,236,257,266,446,470 'deleg':3,5,7,19,22,39,43,52,63,73,92,113,134,144,149,161,165,185,208,223,227,231,240,248,251,260,272,281,298,310,315,326,337,349,351,357,365,373,385,394,398,415,423,427,452,461,478 'delet':197,204,237,465 'descript':222 'detail':104 'diagnos':309 'disconnect':329,353,459 'docker':435 'doesn':418 'error':345 'etc':436 'exampl':245 'execut':157,181,279,291,344 'fail':391 'failur':342 'filter':79,302 'find':148 'get':102,109,164,235,239,280 'har':34,68,87,108,129,156,180,203,388 'health':8,28,229 'health/heartbeat':318 'healthi':249,407 'heartbeat':51,256,360 'helm':434 'host':386 'id':76,78,116,118,120,137,139,167,169,171,190,192,194,211,213,215 'instal':432 'instruct':15 'issu':311,438 'kubectl':433 'last':50,255,359 'least':402 'list':18,20,35,62,69,88,225,226,234,250,300,316,397 'manag':2,4,10,242 'manage-deleg':1 'mani':343 'match':420 'may':330,367 'mcp':14,32,66,85,106,127,154,178,201 'monitor':6 'name':81,94,141 'need':59 'network':381 'new':259,472 'note':307 'old':288 'one':403,473 'oper':221 'org':75,117,136,168,191,212 'org/project':58 'paramet':36,70,89,110,131,158,182,205 'perform':306 'pipelin':341,390,412 'process':366 'prod':96,143,277 'prod-delegate-token':142 'prod-token':95,276 'project':77,119,138,170,193,214,233,265,269,442,448,454 'project-scop':441 're':476 're-regist':475 'recov':469 'regist':451,462,477 'registr':11,243,289 'requir':430 'resourc':37,71,90,111,115,132,159,166,183,189,206,210,216,218 'return':41 'revok':174,188,238,286,292,333,378,456 'saa':389 'scope':56,220,270,443 'selector':416 'show':294,327,352 'skill' 'skill-manage-delegates' 'source-harness' 'stage':264 'stale':363 'status':46,83,98,230,253,304,322 'stem':346 'step':16,60,100,121,146,172,195 'timestamp':361 'token':12,64,74,93,97,103,114,125,135,145,152,162,176,186,199,209,232,244,261,267,278,285,290,299,301,321,334,374,437,439,445,458,466 'tool':33,67,86,107,128,155,179,202,431 'topic-agent-skills' 'topic-agents' 'troubleshoot':340,350 'type':38,72,91,112,133,160,184,207,217,219 'unavail':348 'use':274,413 'verifi':336,371,425 'version':47 'via':13","prices":[{"id":"e6905921-b90b-4b02-844f-096678f9f22c","listingId":"b4451056-3a9b-4293-905f-041f2b51332b","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"harness","category":"harness-skills","install_from":"skills.sh"},"createdAt":"2026-05-09T01:05:28.977Z"}],"sources":[{"listingId":"b4451056-3a9b-4293-905f-041f2b51332b","source":"github","sourceId":"harness/harness-skills/manage-delegates","sourceUrl":"https://github.com/harness/harness-skills/tree/main/skills/manage-delegates","isPrimary":false,"firstSeenAt":"2026-05-09T01:05:28.977Z","lastSeenAt":"2026-05-18T19:06:30.296Z"}],"details":{"listingId":"b4451056-3a9b-4293-905f-041f2b51332b","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"harness","slug":"manage-delegates","github":{"repo":"harness/harness-skills","stars":15,"topics":["agent-skills","agents"],"license":"apache-2.0","html_url":"https://github.com/harness/harness-skills","pushed_at":"2026-05-13T01:28:28Z","description":"A collection of structured AI agent skills that   enable Claude Code, Cursor, GitHub Copilot, and   other AI coding assistants to create, operate,   debug, and govern Harness CI/CD workflows through   natural language.","skill_md_sha":"f417c3e148178b4fcaa0925af5ee594b62703894","skill_md_path":"skills/manage-delegates/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/harness/harness-skills/tree/main/skills/manage-delegates"},"layout":"multi","source":"github","category":"harness-skills","frontmatter":{"name":"manage-delegates","license":"Apache-2.0","description":">-","compatibility":"Requires Harness MCP v2 server (harness-mcp-v2)"},"skills_sh_url":"https://skills.sh/harness/harness-skills/manage-delegates"},"updatedAt":"2026-05-18T19:06:30.296Z"}}