How do I install the Manage Delegates skill?

Run npx skillmds@latest add harness/manage-delegates in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Manage Delegates safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Manage Delegates?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Manage Delegates free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published Manage Delegates?

harness (@harness) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Manage Delegates by harness — Agent Skill

Name: Manage Delegates
Author: harness

Manage Delegates

Monitor and manage Harness Delegates via MCP. List delegates and check health status, manage delegate registration tokens (create, revoke, delete), and find which delegates are associated with a token. Use when asked about delegate status, delegate health, delegate connectivity, delegate tokens, or troubleshooting delegate issues. Trigger phrases: delegate status, delegate health, list delegates, delegate token, delegate connectivity, delegate troubleshooting, delegate down.

harness f417c3e 4.1 KB Updated Sep 17, 2026

File contents

Manage Delegates

Monitor delegate health and manage registration tokens via MCP.

Instructions

Step 1: List Delegates

List all delegates in the account to check health and connectivity:

Call MCP tool: harness_list
Parameters:
  resource_type: "delegate"

This returns all delegates with their status, version, connectivity, and last heartbeat. Delegates are account-scoped -- no org/project needed.

Step 2: List Delegate Tokens

Call MCP tool: harness_list
Parameters:
  resource_type: "delegate_token"
  org_id: "<organization>"
  project_id: "<project>"

Filter by name or status:

Call MCP tool: harness_list
Parameters:
  resource_type: "delegate_token"
  name: "prod-token"
  status: "ACTIVE"

Step 3: Get Token Details

Call MCP tool: harness_get
Parameters:
  resource_type: "delegate_token"
  resource_id: "<token_name>"
  org_id: "<organization>"
  project_id: "<project>"

Step 4: Create a Token

Call MCP tool: harness_create
Parameters:
  resource_type: "delegate_token"
  org_id: "<organization>"
  project_id: "<project>"
  body:
    name: "prod-delegate-token"

Step 5: Find Delegates for a Token

Call MCP tool: harness_execute
Parameters:
  resource_type: "delegate_token"
  action: "get_delegates"
  resource_id: "<token_name>"
  org_id: "<organization>"
  project_id: "<project>"

Step 6: Revoke a Token

Call MCP tool: harness_execute
Parameters:
  resource_type: "delegate_token"
  action: "revoke"
  resource_id: "<token_name>"
  org_id: "<organization>"
  project_id: "<project>"

Step 7: Delete a Token

Call MCP tool: harness_delete
Parameters:
  resource_type: "delegate_token"
  resource_id: "<token_name>"
  org_id: "<organization>"
  project_id: "<project>"

Resource Types

Resource Type	Scope	Operations	Description
`delegate`	Account	list	List delegates with health status
`delegate_token`	Project	list, get, create, delete + revoke, get_delegates actions	Manage registration tokens

Examples

"Are all delegates healthy?" -- List delegates, check status and last heartbeat
"Create a new delegate token for the staging project" -- Create token with project scope
"Which delegates are using the prod-token?" -- Execute get_delegates action on the token
"Revoke the old registration token" -- Execute revoke action
"Show me all active delegate tokens" -- List tokens filtered by status ACTIVE

Performance Notes

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.
Always verify delegate connectivity before troubleshooting pipeline failures -- many execution errors stem from unavailable delegates.

Troubleshooting

Delegate Shows Disconnected

Check the delegate's last heartbeat timestamp -- if stale, the delegate process may be down
Verify the delegate token is ACTIVE (not REVOKED)
Check network connectivity between the delegate host and Harness SaaS

Pipeline Fails with "No Delegates Available"

List delegates to confirm at least one is connected and healthy
Check if the pipeline uses a delegate selector that doesn't match any active delegate
Verify the delegate has the required tools installed (kubectl, helm, docker, etc.)

Token Issues

Tokens are project-scoped -- a token created in project A cannot register delegates for project B
Revoking a token disconnects all delegates registered with it
Deleted tokens cannot be recovered -- create a new one and re-register delegates

---name: manage-delegatesdescription: Monitor and manage Harness Delegates via MCP. List delegates and check health status, manage delegate registration tokens (create, revoke, delete), and find which delegates are associated with a token. Use when asked about delegate status, delegate health, delegate connectivity, delegate tokens, or troubleshooting delegate issues. Trigger phrases: delegate status, delegate health, list delegates, delegate token, delegate connectivity, delegate troubleshooting, delegate down.license: Apache-2.0---# Manage DelegatesMonitor delegate health and manage registration tokens via MCP.## Instructions### Step 1: List DelegatesList all delegates in the account to check health and connectivity:```Call MCP tool: harness_listParameters: resource_type: "delegate"```This returns all delegates with their status, version, connectivity, and last heartbeat. Delegates are account-scoped -- no org/project needed.### Step 2: List Delegate Tokens```Call MCP tool: harness_listParameters: resource_type: "delegate_token" org_id: "<organization>" project_id: "<project>"```Filter by name or status:```Call MCP tool: harness_listParameters: resource_type: "delegate_token" name: "prod-token" status: "ACTIVE"```### Step 3: Get Token Details```Call MCP tool: harness_getParameters: resource_type: "delegate_token" resource_id: "<token_name>" org_id: "<organization>" project_id: "<project>"```### Step 4: Create a Token```Call MCP tool: harness_createParameters: resource_type: "delegate_token" org_id: "<organization>" project_id: "<project>" body: name: "prod-delegate-token"```### Step 5: Find Delegates for a Token```Call MCP tool: harness_executeParameters: resource_type: "delegate_token" action: "get_delegates" resource_id: "<token_name>" org_id: "<organization>" project_id: "<project>"```### Step 6: Revoke a Token```Call MCP tool: harness_executeParameters: resource_type: "delegate_token" action: "revoke" resource_id: "<token_name>" org_id: "<organization>" project_id: "<project>"```### Step 7: Delete a Token```Call MCP tool: harness_deleteParameters: resource_type: "delegate_token" resource_id: "<token_name>" org_id: "<organization>" project_id: "<project>"```## Resource Types| Resource Type | Scope | Operations | Description ||--------------|-------|-----------|-------------|| `delegate` | Account | list | List delegates with health status || `delegate_token` | Project | list, get, create, delete + revoke, get_delegates actions | Manage registration tokens |## Examples- "Are all delegates healthy?" -- List delegates, check status and last heartbeat- "Create a new delegate token for the staging project" -- Create token with project scope- "Which delegates are using the prod-token?" -- Execute get_delegates action on the token- "Revoke the old registration token" -- Execute revoke action- "Show me all active delegate tokens" -- List tokens filtered by status ACTIVE## Performance Notes- 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.- Always verify delegate connectivity before troubleshooting pipeline failures -- many execution errors stem from unavailable delegates.## Troubleshooting### Delegate Shows Disconnected1. Check the delegate's last heartbeat timestamp -- if stale, the delegate process may be down2. Verify the delegate token is ACTIVE (not REVOKED)3. Check network connectivity between the delegate host and Harness SaaS### Pipeline Fails with "No Delegates Available"1. List delegates to confirm at least one is connected and healthy2. Check if the pipeline uses a delegate selector that doesn't match any active delegate3. Verify the delegate has the required tools installed (kubectl, helm, docker, etc.)### Token Issues- Tokens are project-scoped -- a token created in project A cannot register delegates for project B- Revoking a token disconnects all delegates registered with it- Deleted tokens cannot be recovered -- create a new one and re-register delegates

Frequently asked questions

Manage Delegates

File contents

Manage Delegates

Instructions

Step 1: List Delegates

Step 2: List Delegate Tokens

Step 3: Get Token Details

Step 4: Create a Token

Step 5: Find Delegates for a Token

Step 6: Revoke a Token

Step 7: Delete a Token

Resource Types

Examples

Performance Notes

Troubleshooting

Delegate Shows Disconnected

Pipeline Fails with "No Delegates Available"

Token Issues

Related skills

Frequently asked questions

How do I install the Manage Delegates skill?

What does the Manage Delegates skill do?

Is Manage Delegates safe to use?

Which AI agents work with Manage Delegates?

Is Manage Delegates free to use?

Who published Manage Delegates?