recipe-create-classroom-course
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 specific actions within a clear domain (Google Classroom), making it distinctive. However, it critically lacks a 'Use when...' clause, which hurts completeness and reduces Claude's ability to reliably select this skill. Adding trigger guidance and more keyword variations would significantly improve it.
Suggestions
Add a 'Use when...' clause, e.g., 'Use when the user wants to set up a Google Classroom course, add or invite students, or manage class enrollment.'
Include common keyword variations such as 'set up a class', 'add students', 'enroll students', 'Google Classroom setup', or 'class roster'.
| 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 description targets a very specific niche—Google Classroom course creation and student invitation—which is unlikely to conflict with other skills due to the specificity of the platform and actions. | 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.
This is 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 explicit validation steps (e.g., capturing the course ID from step 1, verifying course creation succeeded) and no guidance on handling errors or the COURSE_ID placeholder transition between steps.
Suggestions
Add an explicit note after step 1 to capture the returned course ID for use in subsequent steps, e.g., 'Note the `id` field from the response to use as COURSE_ID below.'
Add a verification step after course creation, such as listing courses to confirm it was created successfully, or at minimum note what a successful response looks like.
| 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 data. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced (create course → invite student → list students), but there's no validation or error handling. For instance, step 2 uses 'COURSE_ID' placeholder without explicitly instructing to capture the course ID from step 1's output, and there's no verification that the invitation was accepted or that the course was created successfully. | 2 / 3 |
Progressive Disclosure | For a simple, short skill under 50 lines, the structure is appropriate. It references a prerequisite skill (`gws-classroom`) clearly and keeps the content focused on the single task at hand. | 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 | |
- Repository
- googleworkspace/cli
- Commit
a3768d0
- 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.