CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

manage-users

Manage Harness users, user groups, and service accounts via MCP. List and search users, create and manage user groups for team-based access, create service accounts for API automation, and view available permissions. Use when asked to list users, create a user group, manage service accounts, check who has access, or set up team permissions. Do NOT use for role assignments or resource groups (use manage-roles instead). Trigger phrases: list users, user group, service account, who has access, team permissions, add user to group, create service account.

74

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, highly actionable body: every operation is given as a concrete MCP call with parameters, the workflow is clearly sequenced, and validation guidance plus troubleshooting sections address risky operations. The main weaknesses are minor — validation checkpoints live in a separate Performance Notes section rather than inline with the destructive steps, and the Resource Types table repeats information already shown in the steps.

Suggestions

Integrate validation into the destructive steps as explicit checkpoints (e.g., in the delete blocks: verify the identifier via harness_get before deleting, and confirm success afterward) instead of keeping all verification in the separate Performance Notes section.

Trim redundancy between the step-by-step parameter blocks and the Resource Types table — for example, drop the Operations column from the table since every step already demonstrates the supported operations.

Add the missing harness_get example for service_account in Step 4, since the Resource Types table lists 'get' as a supported operation for it.

DimensionReasoningScore

Conciseness

The body is dominated by lean, concrete MCP call blocks, but the 'Resource Types' table partially duplicates scope/operation information already demonstrated in the steps, and passages like 'This returns all platform permissions. Use this to understand what permissions can be assigned via roles' could be trimmed. This matches 'Efficient; minor instances of over-explanation that could be trimmed' — it is not level 5 because a few tokens do not earn their place, and not level 3 because there is no genuinely unnecessary concept explanation.

4 / 5

Actionability

Every operation is a concrete, copy-paste-ready MCP tool call with named parameters (e.g., the create user_group body with identifier, name, description, users), and the Examples section maps common requests ('Create a service account for CI automation') to specific actions. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases' — the only gap, a missing get-service_account example, does not affect common-case coverage.

5 / 5

Workflow Clarity

Steps 1–5 give a clear sequence, and validation guidance exists in Performance Notes ('Verify user email addresses and group identifiers before making changes', 'List existing groups and service accounts before creating to avoid duplicates') with troubleshooting covering error recovery (e.g., 'Try searching by email address instead of display name'). It is not level 5 because the destructive delete operations lack inline checkpoints and post-operation verification, and not level 3 because pre-change verification steps are explicitly present rather than absent.

4 / 5

Progressive Disclosure

No bundle files exist, and the single-file body is well-sectioned (Instructions, Resource Types, Relationship to /manage-roles, Examples, Performance Notes, Troubleshooting) with the /manage-roles cross-reference clearly signaled. This matches 'Good structure; most content is appropriately placed; references mostly clear; minor organization gaps' — at ~173 lines with some step/table redundancy, it is not the lean, fully-split structure of the level-5 anchor, but well above the poorly organized level-3 anchor.

4 / 5

Total

17

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it states concrete capabilities in third person, answers both 'what' and 'when' explicitly with a dedicated trigger-phrase list, and actively prevents mis-triggering with a 'Do NOT use for role assignments or resource groups' boundary pointing to the sibling skill. No fluff, buzzwords, or over-claims are present.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'List and search users', 'create and manage user groups for team-based access', 'create service accounts for API automation', 'view available permissions' — comprehensively covering the skill's scope. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' and exceeds the level-4 anchor, which expects only several actions with gaps.

5 / 5

Completeness

Both questions are explicitly answered: the 'what' via concrete capability statements and the 'when' via 'Use when asked to list users, create a user group, manage service accounts, check who has access, or set up team permissions' plus an explicit trigger-phrase list. This matches the anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'; level 4 would require the 'when' to be less explicit.

5 / 5

Trigger Term Quality

'Trigger phrases: list users, user group, service account, who has access, team permissions, add user to group, create service account' provides comprehensive coverage of natural terms users would actually say, matching the anchor for comprehensive natural-term coverage including phrasing variations. It is not the level-4 anchor because few natural terms are missing — 'add user to group' and 'who has access' capture common colloquial phrasings.

5 / 5

Distinctiveness Conflict Risk

The description is scoped to 'Harness users, user groups, and service accounts via MCP' — a clear niche — and adds explicit disambiguation: 'Do NOT use for role assignments or resource groups (use manage-roles instead)'. This matches the anchor 'Clear niche with distinct triggers; minimal conflict risk'; level 4 would involve minor overlap risk with closely related skills, which the explicit manage-roles redirect preempts.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

harness/harness-ai

Path

plugins/claude/skills/manage-users/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.