paperclip-board

Manage a Paperclip company as a board member via chat. Use when the user wants onboarding, company or agent management, approvals, task monitoring, cost oversight, or work product review in the Paperclip control plane.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/paperclip-board/SKILL.md

Quality

Content

71%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 content is highly actionable with executable curl examples and clearly sequenced workflows backed by write-path-freshness validation. Its main weaknesses are length/redundancy and a lack of progressive disclosure — large reference material lives inline instead of in separate files.

Suggestions

Move the 'Key Endpoints Reference' table and the full 'Agent System Prompt Template' into separate reference files (e.g., references/endpoints.md, references/system-prompt-template.md) and link to them from SKILL.md to improve progressive disclosure.

Remove the duplicate endpoint table or the inline endpoint listings to reduce redundancy, since the same routes appear in both the per-section examples and the reference table.

Trim the ASCII presentation-format templates to one representative example per section, or move them to a reference file, to reduce token bulk.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient and assumes Claude's competence, but the closing 'Key Endpoints Reference' table duplicates endpoints already shown inline and the ASCII presentation templates add bulk that could be trimmed.	3 / 5
Actionability	Fully executable copy-paste curl commands with complete JSON bodies cover onboarding, hiring, approvals, tasks, monitoring, and costs — concrete and specific across common cases.	5 / 5
Workflow Clarity	Multi-step flows (Onboarding Steps 1-4, Hiring Plan Loop, Cross-Agent Escalation) are clearly sequenced with an explicit 're-read before modifying' write-path-freshness checkpoint and approval gates; minor validation gaps remain in a few examples.	4 / 5
Progressive Disclosure	Sections are well organized with clear headers, but ~600 lines are monolithic with no bundle files or one-level-deep references; the endpoint reference and agent system-prompt template are inlined rather than split out.	3 / 5
	Total	15 / 20 Passed

Description

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

The description is strong: it clearly states what the skill does and when to use it, with a well-scoped Paperclip board-management niche and concrete trigger terms. Minor improvement could come from phrasing capabilities as actions rather than domains.

Dimension	Reasoning	Score
Specificity	Lists several concrete capability areas — 'onboarding, company or agent management, approvals, task monitoring, cost oversight, or work product review' — though they are domains rather than granular actions, leaving minor coverage gaps.	4 / 5
Completeness	Explicitly answers both what ('Manage a Paperclip company as a board member via chat') and when ('Use when the user wants...') with concrete trigger phrases, in third person.	5 / 5
Trigger Term Quality	'Use when the user wants onboarding, company or agent management, approvals, task monitoring, cost oversight, or work product review' provides good natural keyword coverage, though 'Paperclip control plane' leans slightly technical.	4 / 5
Distinctiveness Conflict Risk	The Paperclip-specific framing and 'board member via chat' niche give it clear distinct triggers with minimal conflict risk against other skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (620 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: paperclipai/paperclip
Path: skills/paperclip-board/SKILL.md
Commit: 890ab9a

Reviewed: about 17 hours ago

Table of Contents

Discovery Implementation Validation

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.