Name: personwise/personwise-student-orientation
Rating: 68.8 (1 reviews)
Author: personwise

personwise/personwise-student-orientation

Every cohort arrives asking the same questions, and student services answers them all term. Turn your handbook and orientation materials into an interactive digital-human student orientation course that prepares new students before day one and stays askable after. Fees, visas, housing, and policies come only from your documents — never invented.

Quality

86%

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

Quality

Content

81%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 highly actionable, well-sequenced workflow with strong validation checkpoints and error-recovery feedback loops. The main weakness is conciseness: the source-pending no-op and update-freshness material is repeated across sections and the single file is dense for this scope.

Suggestions

Consolidate the awaiting_sources / source-pending no-op guidance into one section and reference it rather than re-explaining it in 'Run the course workflow' and 'Finish, recover, and report'.

Extract the detailed CLI/Skill update-freshness handling ('Keep the CLI and this Skill current') into a one-level reference file, keeping only the core 'update check' step inline.

Tighten repeated phrasing around idempotency and conflict handling into a single authoritative statement to reduce token overhead.

Dimension	Reasoning	Score
Conciseness	Mostly efficient procedural guidance that assumes Claude's competence, but the awaiting_sources/no-op behavior and update-freshness handling are re-explained across multiple sections, adding redundancy that could be tightened.	3 / 5
Actionability	Fully executable commands with exact flags and JSON inputs throughout ('personwise --account <alias> course readiness --json', 'course create --input <blueprint.json> --json', 'source add ... --json'), covering the common cases copy-paste ready.	5 / 5
Workflow Clarity	Clear end-to-end sequence (version → bootstrap → auth → readiness → blueprint → sources → wait → review → publish) with explicit validation checkpoints (readiness before blueprint, source status before advance, expected-revision, fresh re-reads) and feedback loops for error recovery.	5 / 5
Progressive Disclosure	Well-sectioned with clear one-level references to real bundle files (assets/bootstrap.sh, assets/bootstrap.ps1), but the SKILL.md is fairly long and monolithic for a workflow this size — some update-freshness detail could live in a reference.	4 / 5
	Total	17 / 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.

A strong, specific description that clearly states what it does, when to use it with natural trigger language, and how it stays distinct from other skills. Minor room to sharpen the action list, but it answers both 'what' and 'when' explicitly.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete actions — 'Produce a grounded interactive digital-human course learners can interrupt with voice questions', 'install or update the official PersonWise CLI', 'uses browser OAuth' — but bundles them around one workflow rather than a comprehensive discrete-action list.	4 / 5
Completeness	Explicitly answers both 'what' ('Produce a grounded interactive digital-human course...') and 'when' with concrete trigger phrases ('Use when the user asks for Student Orientation... Trigger language: ...').	5 / 5
Trigger Term Quality	Provides natural trigger phrases ('student orientation; new student orientation; international student orientation') users would actually say; good coverage though a few synonyms/extensions are absent.	4 / 5
Distinctiveness Conflict Risk	Clear niche (PersonWise Student Orientation from supplied materials) with distinct triggers and an explicit exclusion of other course-creation requests, minimizing conflict risk.	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
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Reviewed

21 days ago

Table of Contents

Discovery Implementation Validation