CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

onboard

Interactive three-part onboarding for new team members to the Trellis AI-assisted workflow system. Covers core philosophy (AI memory, project-specific knowledge, context drift), system structure and command deep-dives, real-world workflow examples, and guideline customization. Use when a new developer joins the project, someone needs to understand the Trellis workflow, or project guidelines need initial setup.

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/onboard/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 body delivers a well-sequenced, actionable onboarding script with concrete commands and verbatim dialogue, but it is a monolithic ~360 lines with notable redundancy. The three-part structure is repeated three times and the philosophy section over-explains generic AI limitations Claude already knows.

Suggestions

State the three-part structure once in the opening section and delete the restatements in the PART 3 intro and "Completing the Onboard Session"; cut "KEY RULES TO EMPHASIZE" since it duplicates the skill deep-dives.

Move the five real-world workflow examples and/or the six skill deep-dives into references/ files (e.g., references/examples.md, references/skills.md) linked from a concise overview, converting the monolith into a lean SKILL.md with one-level-deep references.

Compress the CORE PHILOSOPHY section to one-line principles plus the Trellis-specific solution for each challenge — Claude already knows AI lacks memory and has a limited context window; only the .trellis mechanisms are new information.

DimensionReasoningScore

Conciseness

Mostly efficient but padded: the three-part structure is restated three times ("CRITICAL INSTRUCTION" list, the PART 3 intro, and the closing summary), "KEY RULES TO EMPHASIZE" duplicates the skill deep-dives, and passages like "Every AI session starts with a blank slate" re-explain concepts Claude already knows. The bulk is distinct, useful content, so this is anchor 3 rather than the more heavily padded anchor 2.

3 / 5

Actionability

Provides executable commands (grep for "To be filled by the team", `python3 ./.trellis/scripts/task.py create …`), an 11-file guideline checklist, and verbatim dialogue scripts for Situations A and B. Mostly executable with minor gaps — steps like "Analyze the codebase" and "Investigate and fix the bug" stay abstract — matching anchor 4 rather than fully copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

The Parts 1→2→3 sequence is explicit, examples are numbered ([1/8]…[8/8]), and Part 3 opens with a state-validation checkpoint (grep the spec files, then branch on Situation A vs B) before acting. Anchor 4 rather than 5 because there is no feedback loop verifying the guideline-filling work, and inter-part transitions rely on exhortation ("DO NOT skip any part") instead of checkpoints; no destructive or batch operations, so no cap applies.

4 / 5

Progressive Disclosure

No bundle files exist and the entire ~360-line skill — six skill deep-dives and five real-world examples, material that naturally belongs in reference files — is inlined in one monolith, though with clear section headers. This matches anchor 3 (content that should be separate is inline); it is not anchor 2 because the structure is well organized, and not anchor 4 because nothing is split out into separate files.

3 / 5

Total

14

/

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 gives three explicit, natural "Use when…" triggers, with a distinct Trellis-specific niche. Trigger coverage is good though a few everyday synonyms are absent.

DimensionReasoningScore

Specificity

Lists several specific components — "core philosophy (AI memory, project-specific knowledge, context drift), system structure and command deep-dives, real-world workflow examples, and guideline customization" — with minor gaps. It names topical coverage rather than concrete actions like the anchor-5 example, so it sits at anchor 4.

4 / 5

Completeness

Explicitly answers both questions: the "what" ("Interactive three-part onboarding… Covers core philosophy…, system structure and command deep-dives, real-world workflow examples, and guideline customization") and a concrete "when" ("Use when a new developer joins the project, someone needs to understand the Trellis workflow, or project guidelines need initial setup"). This matches anchor 5; the when-clause is explicit with multiple concrete triggers, not the weaker when of anchor 4.

5 / 5

Trigger Term Quality

Natural trigger phrases include "onboarding", "new team members", "new developer joins the project", "understand the Trellis workflow", and "project guidelines need initial setup", with good synonym coverage. A few natural variants (e.g., "training", "intro to the workflow") are missing, matching anchor 4 rather than comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

"Trellis AI-assisted workflow system" carves out a clear niche and all triggers are Trellis/onboarding-specific, giving minimal conflict risk with other skills. Matches anchor 5; it is more distinct than the minor-overlap case of anchor 4.

5 / 5

Total

18

/

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

202780181/lingxiData

Path

.agents/skills/onboard/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.