{"id":"28e27310-ce1a-4285-b01a-9ec927174ccb","shortId":"ASzzQp","kind":"skill","title":"manage-users","tagline":">-","description":"# Manage Users\n\nManage users, user groups, and service accounts via MCP.\n\n## Instructions\n\n### Step 1: List Users\n\n```\nCall MCP tool: harness_list\nParameters:\n  resource_type: \"user\"\n  search_term: \"<name or email>\"\n```\n\nUsers are account-scoped. Use `search_term` to filter by name or email.\n\n### Step 2: Get User Details\n\n```\nCall MCP tool: harness_get\nParameters:\n  resource_type: \"user\"\n  resource_id: \"<user_id>\"\n```\n\n### Step 3: Manage User Groups\n\nList groups:\n\n```\nCall MCP tool: harness_list\nParameters:\n  resource_type: \"user_group\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n  search_term: \"<group name>\"\n```\n\nGet group details:\n\n```\nCall MCP tool: harness_get\nParameters:\n  resource_type: \"user_group\"\n  resource_id: \"<group_identifier>\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n```\n\nCreate a group:\n\n```\nCall MCP tool: harness_create\nParameters:\n  resource_type: \"user_group\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n  body:\n    identifier: \"backend_team\"\n    name: \"Backend Team\"\n    description: \"Backend engineering team\"\n    users:\n      - \"<user_id_1>\"\n      - \"<user_id_2>\"\n```\n\nDelete a group:\n\n```\nCall MCP tool: harness_delete\nParameters:\n  resource_type: \"user_group\"\n  resource_id: \"<group_identifier>\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n```\n\n### Step 4: Manage Service Accounts\n\nList service accounts:\n\n```\nCall MCP tool: harness_list\nParameters:\n  resource_type: \"service_account\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n```\n\nCreate a service account:\n\n```\nCall MCP tool: harness_create\nParameters:\n  resource_type: \"service_account\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n  body:\n    identifier: \"ci_bot\"\n    name: \"CI Bot\"\n    description: \"Service account for CI pipeline automation\"\n    email: \"ci-bot@harness.io\"\n```\n\nDelete a service account:\n\n```\nCall MCP tool: harness_delete\nParameters:\n  resource_type: \"service_account\"\n  resource_id: \"<service_account_identifier>\"\n  org_id: \"<organization>\"\n  project_id: \"<project>\"\n```\n\n### Step 5: List Available Permissions\n\n```\nCall MCP tool: harness_list\nParameters:\n  resource_type: \"permission\"\n```\n\nThis returns all platform permissions. Use this to understand what permissions can be assigned via roles.\n\n## Resource Types\n\n| Resource Type | Scope | Operations | Description |\n|--------------|-------|-----------|-------------|\n| `user` | Account | list, get | Platform users (read-only) |\n| `user_group` | Project | list, get, create, delete | User groups for RBAC |\n| `service_account` | Project | list, get, create, delete | API automation accounts |\n| `permission` | Account | list | Available permissions (read-only) |\n\n## Relationship to /manage-roles\n\nThis skill manages **principals** (users, groups, service accounts). Use `/manage-roles` to assign **roles** and **resource groups** to these principals:\n\n1. `/manage-users` -- Create the user group or service account\n2. `/manage-roles` -- Assign a role + resource group to that principal\n\n## Examples\n\n- \"List all users in the account\" -- List users with no filter\n- \"Find user john.doe\" -- List users with search_term \"john.doe\"\n- \"Create a user group for the platform team\" -- Create user_group with member user IDs\n- \"Create a service account for CI automation\" -- Create service_account\n- \"What permissions are available?\" -- List permissions\n- \"Delete the old test-bot service account\" -- Delete service_account\n\n## Performance Notes\n\n- Verify user email addresses and group identifiers before making changes.\n- List existing groups and service accounts before creating to avoid duplicates.\n- For service accounts, confirm the token expiry and scope match the intended usage.\n\n## Troubleshooting\n\n### User Not Found\n- Users are account-scoped -- no org/project needed\n- Try searching by email address instead of display name\n- User must be invited to the account before they appear\n\n### Cannot Create User\n- Users cannot be created via API -- they must be invited through the Harness UI or SCIM provisioning\n- Use user groups and service accounts for programmatic access\n\n### Service Account Has No Access\n- Creating a service account alone does not grant permissions\n- Use `/manage-roles` to assign a role to the service account\n- Generate an API key for the service account via the Harness UI","tags":["manage","users","harness","skills","agent-skills","agents"],"capabilities":["skill","source-harness","skill-manage-users","topic-agent-skills","topic-agents"],"categories":["harness-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/harness/harness-skills/manage-users","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 (4,320 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.913Z","embedding":null,"createdAt":"2026-05-09T01:05:29.590Z","updatedAt":"2026-05-18T19:06:30.913Z","lastSeenAt":"2026-05-18T19:06:30.913Z","tsv":"'/manage-roles':304,314,334,517 '/manage-users':325 '1':17,324 '2':46,333 '3':62 '4':152 '5':228 'access':501,506 'account':12,34,155,158,168,176,186,200,210,220,265,285,293,295,312,332,349,382,388,402,405,423,431,449,469,498,503,510,525,533 'account-scop':33,448 'address':411,458 'alon':511 'api':291,481,528 'appear':472 'assign':254,316,335,519 'autom':204,292,385 'avail':230,297,392 'avoid':427 'backend':122,125,128 'bodi':120,191 'bot':194,197,400 'call':20,50,68,87,106,135,159,177,211,232 'cannot':473,477 'chang':417 'ci':193,196,202,384 'ci-bot@harness.io':206 'confirm':432 'creat':103,110,173,181,278,289,326,364,372,379,386,425,474,479,507 'delet':132,139,207,215,279,290,395,403 'descript':127,198,263 'detail':49,86 'display':461 'duplic':428 'email':44,205,410,457 'engin':129 'exampl':343 'exist':419 'expiri':435 'filter':40,354 'find':355 'found':445 'generat':526 'get':47,54,84,91,267,277,288 'grant':514 'group':9,65,67,77,85,96,105,115,134,144,274,281,310,320,329,339,367,374,413,420,495 'har':23,53,71,90,109,138,162,180,214,235,488,536 'id':60,79,81,98,100,102,117,119,146,148,150,170,172,188,190,222,224,226,378 'identifi':121,192,414 'instead':459 'instruct':15 'intend':440 'invit':466,485 'john.doe':357,363 'key':529 'list':18,24,66,72,156,163,229,236,266,276,287,296,344,350,358,393,418 'make':416 'manag':2,4,6,63,153,307 'manage-us':1 'match':438 'mcp':14,21,51,69,88,107,136,160,178,212,233 'member':376 'must':464,483 'name':42,124,195,462 'need':453 'note':407 'old':397 'oper':262 'org':78,99,116,147,169,187,223 'org/project':452 'paramet':25,55,73,92,111,140,164,182,216,237 'perform':406 'permiss':231,240,245,251,294,298,390,394,515 'pipelin':203 'platform':244,268,370 'princip':308,323,342 'programmat':500 'project':80,101,118,149,171,189,225,275,286 'provis':492 'rbac':283 'read':271,300 'read-on':270,299 'relationship':302 'resourc':26,56,59,74,93,97,112,141,145,165,183,217,221,238,257,259,319,338 'return':242 'role':256,317,337,521 'scim':491 'scope':35,261,437,450 'search':29,37,82,361,455 'servic':11,154,157,167,175,185,199,209,219,284,311,331,381,387,401,404,422,430,497,502,509,524,532 'skill':306 'skill-manage-users' 'source-harness' 'step':16,45,61,151,227 'team':123,126,130,371 'term':30,38,83,362 'test':399 'test-bot':398 'token':434 'tool':22,52,70,89,108,137,161,179,213,234 'topic-agent-skills' 'topic-agents' 'tri':454 'troubleshoot':442 'type':27,57,75,94,113,142,166,184,218,239,258,260 'ui':489,537 'understand':249 'usag':441 'use':36,246,313,493,516 'user':3,5,7,8,19,28,31,48,58,64,76,95,114,131,143,264,269,273,280,309,328,346,351,356,359,366,373,377,409,443,446,463,475,476,494 'verifi':408 'via':13,255,480,534","prices":[{"id":"b4e4b23b-f6ea-4c5a-8988-35084821fecb","listingId":"28e27310-ce1a-4285-b01a-9ec927174ccb","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:29.590Z"}],"sources":[{"listingId":"28e27310-ce1a-4285-b01a-9ec927174ccb","source":"github","sourceId":"harness/harness-skills/manage-users","sourceUrl":"https://github.com/harness/harness-skills/tree/main/skills/manage-users","isPrimary":false,"firstSeenAt":"2026-05-09T01:05:29.590Z","lastSeenAt":"2026-05-18T19:06:30.913Z"}],"details":{"listingId":"28e27310-ce1a-4285-b01a-9ec927174ccb","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"harness","slug":"manage-users","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":"202819f8f09a3551d4bc7d4d7010e38c6a14329c","skill_md_path":"skills/manage-users/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/harness/harness-skills/tree/main/skills/manage-users"},"layout":"multi","source":"github","category":"harness-skills","frontmatter":{"name":"manage-users","license":"Apache-2.0","description":">-","compatibility":"Requires Harness MCP v2 server (harness-mcp-v2)"},"skills_sh_url":"https://skills.sh/harness/harness-skills/manage-users"},"updatedAt":"2026-05-18T19:06:30.913Z"}}