CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

policy-lookup

Find and explain company policies in plain language. Trigger with "what's our PTO policy", "can I work remotely from another country", "how do expenses work", or any plain-language question about benefits, travel, leave, or handbook rules.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./human-resources/skills/policy-lookup/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The skill delivers concrete, actionable guidance with a good output template and sensible guardrails. Its main issues are redundancy (the ASCII diagram duplicates the connectors section), undefined search mechanics, and stray "~~" template artifacts that corrupt the connector instructions.

Suggestions

Remove the ASCII box diagram under "How It Works" — it duplicates the "If Connectors Available" section at ~14 lines of token cost for no new information.

Fix the stray "~~" artifacts ("Search ~~knowledge base", "**~~knowledge base**", "**~~HRIS**") which render as strikethrough and look like broken placeholders; replace with plain connector names.

Specify how to search when a knowledge base is connected (e.g., what to query for, how to confirm a matched policy section is authoritative before citing it), since step 1 of "How to Answer" is currently undefined.

DimensionReasoningScore

Conciseness

The 14-line ASCII box diagram entirely duplicates the "If Connectors Available" section, and the Tips section restates guidance already implied elsewhere — more than minor over-explanation but not severely padded throughout. The core sections (How to Answer, Output) are efficient, fitting the 'mostly efficient but could be tightened' anchor.

3 / 5

Actionability

Gives a concrete 5-step answer procedure, explicit guardrails ("Always cite the source document and section"), and a copy-paste-ready markdown output template. It falls short of fully executable because of the stray "~~" artifacts in "Search ~~knowledge base" and "If **~~knowledge base** / **~~HRIS** is connected", which read as broken template placeholders and muddy the connector instructions.

4 / 5

Workflow Clarity

"How to Answer" lists a clear 1-5 sequence with an explicit failure checkpoint ("If no policy is found, say so clearly rather than guessing") and an escalation path ("recommend consulting HR or legal directly"). It is not a 5 because the search step itself is undefined — no guidance on how to query the knowledge base or how to confirm the found policy actually matches the question before answering.

4 / 5

Progressive Disclosure

Well-organized single-file structure with clear section headers and no nested references; the only external pointer is a clearly signaled link to CONNECTORS.md. It misses 5 because the body exceeds the simple-skill threshold (about 85 lines) and inline content like the topic taxonomy and connector details could live in reference files, though nothing is buried or misplaced.

4 / 5

Total

15

/

20

Passed

Description

86%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 description: concrete what/when structure, natural trigger phrases, and third-person voice. The only weakness is that the capability statement stays at two generic verbs (find, explain) rather than enumerating the specific actions the skill performs.

DimensionReasoningScore

Specificity

"Find and explain company policies in plain language" names the domain and exactly two concrete actions (find, explain), matching the anchor for domain plus 1-2 concrete actions. It does not list several specific actions (e.g., searching handbooks, pulling balances, citing sections), so it is not a 4.

3 / 5

Completeness

Explicitly answers what ("Find and explain company policies in plain language") and when ("Trigger with ... or any plain-language question about benefits, travel, leave, or handbook rules") with concrete trigger phrases, matching the top anchor exactly. Voice is third person, so no voice penalty applies.

5 / 5

Trigger Term Quality

Includes fully natural user phrasings ("what's our PTO policy", "can I work remotely from another country", "how do expenses work") plus synonym coverage of the domain ("benefits, travel, leave, or handbook rules"). File extensions are not applicable to this domain, and no common variation is obviously missing, so the comprehensive anchor fits better than 4.

5 / 5

Distinctiveness Conflict Risk

The HR/company-policy niche with concrete trigger phrases is mostly distinct with only minor overlap risk against closely related skills (e.g., a generic document-search or HR-benefits skill). It lacks the fully distinct, minimal-conflict profile of the 5 anchor because "any plain-language question about benefits, travel, leave" is fairly broad, but it is clearly above the 'somewhat specific' level 3.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

anthropics/knowledge-work-plugins

Path

human-resources/skills/policy-lookup/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.