CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

human-management

Use when admin requests adding a human user to the system, changing human permissions, removing human access, or managing human accounts.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

87%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.

An exemplary lean SKILL.md body: copy-paste-ready commands, high-value gotchas, and a clean one-level-deep reference split verified against the actual bundle. The single notable gap is the absence of validation or verification steps around its destructive operations (deleting humans, recalculating permission levels), which caps workflow clarity.

Suggestions

Add verification steps after destructive or permission-changing operations, e.g. run 'agt get humans <name> -o json' after a level change to confirm the recalculated groupAllowFrom entries, or confirm the human no longer appears after 'agt delete human'.

Note in the Operation Reference that 'agt delete human' is irreversible and should be confirmed with the admin before execution, providing an explicit checkpoint for the destructive path.

DimensionReasoningScore

Conciseness

Every line carries non-obvious project knowledge — the groupAllowFrom mechanics, ignored-flag semantics, auto-registered Matrix accounts, and the no-container/MinIO/Higress exception — with zero padding or explanation of concepts Claude already knows. This matches the 'lean and efficient; every token earns its place' anchor exactly.

5 / 5

Actionability

The Quick Create block is a complete, copy-paste-ready bash invocation with realistic values, and the Operation Reference gives concrete executable commands ('agt get humans', 'agt delete human <name>'). This matches the 'fully executable, copy-paste ready, covers common cases' anchor.

5 / 5

Workflow Clarity

The body delegates the create workflow to the reference and offers no sequence for the destructive operations it surfaces ('agt delete human', level changes that recalculate all groupAllowFrom). Per the rubric, a skill involving destructive operations without validation/verification steps is capped at 3 regardless of simplicity — checkpoints are absent, not merely implicit, so it cannot score 4.

3 / 5

Progressive Disclosure

The body is a clear overview that splits detail correctly: the full workflow lives one level deep in references/create-human.md (verified to exist and to not nest further), and the Operation Reference table maps each admin intent to the right file or command. This matches the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

18

/

20

Passed

Description

66%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.

A strong trigger-focused description with explicit, natural 'Use when' phrasing covering add/change/remove operations. Its main weakness is the complete absence of a capability statement — the reader only learns when to invoke the skill, not what it does (import human accounts into AgentTeams with configurable permission levels).

Suggestions

Prepend a capability statement before the 'Use when' clause, e.g. 'Import real human accounts into AgentTeams with configurable permission levels.' so the description answers both what and when.

Replace the redundant 'or managing human accounts' with distinct natural synonyms such as 'onboarding or offboarding human users' to broaden trigger coverage.

DimensionReasoningScore

Specificity

Lists four concrete actions ("adding a human user", "changing human permissions", "removing human access", "managing human accounts"), matching the 'several specific actions with minor gaps' anchor. It falls short of 5 because 'managing human accounts' is generic and largely redundant with the other listed actions, and the actions are framed as trigger conditions rather than stated capabilities.

4 / 5

Completeness

The 'when' is explicit and detailed (four concrete trigger phrases), but the description contains no 'what' capability statement — it never says what the skill actually does. This sits between anchor 2 ('only when present') and anchor 3; the rich trigger list weakly implies the what, so 3 rather than 2, but it cannot reach 4 without a stated capability.

3 / 5

Trigger Term Quality

Includes natural admin phrasings users would actually say — "adding a human user", "changing human permissions", "removing human access" — matching the 'good keyword coverage, a few natural terms missing' anchor. Not 5 because common synonyms like 'onboard', 'offboard', 'revoke', or 'delete user' are absent.

4 / 5

Distinctiveness Conflict Risk

The 'human' qualifier consistently applied across all trigger phrases distinguishes it from generic agent or user-management skills, matching 'mostly distinct; minor overlap risk'. Not 5 because phrases like 'changing permissions' or 'managing accounts' could still overlap with a generic user-administration skill.

4 / 5

Total

15

/

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

agentscope-ai/AgentTeams

Path

manager/agent/skills/human-management/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.