Create a Google Classroom course and invite students.
74
68%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/recipe-create-classroom-course/SKILL.mdQuality
Discovery
50%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 concise and names a specific platform (Google Classroom) with two concrete actions, giving it good distinctiveness. However, it lacks a 'Use when...' clause, which is critical for Claude to know when to select this skill. Adding trigger guidance and more keyword variations would significantly improve its effectiveness.
Suggestions
Add a 'Use when...' clause, e.g., 'Use when the user asks to set up a Google Classroom course, create a class, or add/invite students to a classroom.'
Include common keyword variations such as 'set up a class', 'enroll students', 'add students', 'classroom setup', or 'Google Classroom integration'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists two specific concrete actions: 'Create a Google Classroom course' and 'invite students.' These are clear, actionable capabilities. | 3 / 3 |
Completeness | The description answers 'what does this do' but completely lacks a 'Use when...' clause or any explicit trigger guidance, which per the rubric should cap completeness at 2, and since the 'when' is entirely missing, it scores 1. | 1 / 3 |
Trigger Term Quality | Includes natural keywords like 'Google Classroom', 'course', and 'invite students' which users might say, but misses common variations like 'add students', 'set up a class', 'classroom setup', or 'enroll students'. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'Google Classroom' specifically creates a clear niche that is unlikely to conflict with other skills. This is a very distinct domain. | 3 / 3 |
Total | 9 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A concise, actionable skill that provides clear CLI commands for creating a Google Classroom course and inviting students. Its main weakness is the lack of validation steps—there's no guidance on capturing the COURSE_ID from step 1 or verifying that invitations succeeded. The workflow would benefit from explicit output capture and error handling.
Suggestions
Add explicit instruction to capture COURSE_ID from the output of step 1, e.g., 'Note the courseId from the response and use it in subsequent steps.'
Add a verification step after creating the course (e.g., `gws classroom courses get`) and after inviting students to confirm success.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Very lean and efficient. No unnecessary explanations of what Google Classroom is or how APIs work. Every line serves a purpose. | 3 / 3 |
Actionability | Provides fully concrete, copy-paste ready CLI commands with specific JSON payloads and flags. The commands are executable and include realistic example values. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced, but there's no validation or error handling. Step 2 uses 'COURSE_ID' placeholder without explicitly instructing to capture it from step 1's output. No feedback loop for failed invitations or verification that the course was created successfully. | 2 / 3 |
Progressive Disclosure | For a simple, single-purpose skill under 50 lines, the structure is appropriate. It references the prerequisite skill clearly and keeps content well-organized without unnecessary nesting. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 10 / 11 Passed | |
c7c6646
Table of Contents
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.