CtrlK
BlogDocsLog inGet started
Tessl Logo

company-creator

Create agent company packages that conform to agentcompanies/v1. Use when asked to create a company, scaffold an agent team, hire agents, or turn a repo/skills collection into a company package.

65

Quality

79%

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 ./.agents/skills/company-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 well-structured, highly actionable instruction skill with an explicit multi-step process, an interview checkpoint, and real one-level-deep reference files. The main weaknesses are motivational prose that pads the token budget and the absence of an explicit output-validation step before the final summary.

Suggestions

Trim rationale sentences (e.g. the 'a company is not just a list of agents' and 'this turns a collection of agents into an organization' passages) to pure directives — the rules are already self-explanatory.

Move the detailed .paperclip.yaml adapter/env examples and the external-skill-references YAML block into a reference file (e.g. references/paperclip-config.md), keeping only the rules and one minimal example inline.

Add an explicit validation checkpoint in Step 7: before summarizing, re-check the generated package against the spec's conventions (slug format, schema field, reportsTo chain) and fix any mismatches.

DimensionReasoningScore

Conciseness

Mostly efficient rule-dense prose, but includes several unnecessary rationale passages that could be tightened: "A company is not just a list of agents with skills. It's an organization that takes ideas and turns them into work products", "This turns a collection of agents into an organization that actually works together. Without workflow context, agents operate in isolation — they do their job but don't know what happens before or after them", and "If you don't know what adapter the user wants, omit the adapter block entirely" repeated against "Do not specify an adapter unless...". Fits anchor 3 (mostly efficient, some unnecessary explanation) better than 4, since more than minor trimming is possible.

3 / 5

Actionability

Fully concrete instruction-only guidance: an exact directory tree, a copy-paste YAML sources block, two complete .paperclip.yaml examples, the executable command `git ls-remote https://github.com/owner/repo HEAD`, the literal references footer, and the import command `paperclipai company import --from <path>`. Every step names exactly what to produce. Per the code-vs-instruction note, absence of code is not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

A clear 7-step sequence (gather context → interview via AskUserQuestion → read the spec → generate → confirm output location → write README/LICENSE → write and summarize) with an enforced alignment checkpoint ("Do not skip this step") and a read-before-generate gate. Missing a post-generation validation step (re-checking files against the spec or slugs rules before summarizing), so it matches anchor 4's 'most checkpoints present, minor validation gaps' rather than 5's explicit feedback loops.

4 / 5

Progressive Disclosure

All three referenced files exist (references/companies-spec.md, example-company.md, from-repo-guide.md), are clearly signaled in the body, and are one level deep (no nested references inside them). However, the ~270-line body inlines detailed material that could be split — the .paperclip.yaml guidelines with two full YAML examples and the external-skill-references YAML are natural separate reference files — so it fits anchor 4 rather than 5's fully appropriate split.

4 / 5

Total

16

/

20

Passed

Description

83%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: concise, third-person, buzzword-free, with an explicit 'Use when' clause carrying four concrete trigger phrases. Both 'what' and 'when' are clearly answered, and the niche is well-differentiated.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Create agent company packages", "scaffold an agent team", "hire agents", "turn a repo/skills collection into a company package" — but stops short of comprehensive coverage of what generation involves (files, README, licensing live only in the body). Not a 5 because coverage has minor gaps; not a 3 because multiple specific actions are named, not just a domain.

4 / 5

Completeness

Explicitly answers both: what ("Create agent company packages that conform to agentcompanies/v1") and when ("Use when asked to create a company, scaffold an agent team, hire agents, or turn a repo/skills collection into a company package") with four concrete trigger phrases. Third person throughout. Not a 4 because the 'when' clause is already explicit and specific.

5 / 5

Trigger Term Quality

Natural phrases users would actually say: "create a company", "scaffold an agent team", "hire agents", "turn a repo... into a company package". A few natural synonyms are missing (e.g. "build an org", "agent organization"), so it fits anchor 4 rather than 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche (agent companies / agentcompanies/v1) with distinct triggers like "scaffold an agent team" and "hire agents". Minor overlap risk remains — a bare request to "create a company" could be about business docs or incorporation, so it is not anchor 5's minimal-conflict profile.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository
paperclipai/paperclip
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.