comprehensive-skill
npx machina-cli add skill martinemde/skillet/comprehensive-skill --openclawComprehensive Skill
This skill demonstrates all possible frontmatter fields and features.
Overview
This skill is designed to test the complete parsing and execution pipeline of the skillet CLI tool. It includes all optional frontmatter fields and demonstrates proper formatting.
Prerequisites
- Git must be installed
- Docker must be installed
- Internet access is required
Instructions
Step 1: Initialize
First, check the environment:
git --version
docker --version
Step 2: Execute
Perform the main task according to user requirements.
Step 3: Report
Provide a detailed summary of actions taken.
Output Format
Results should be formatted as:
Task: [task name]
Status: [success/failure]
Details: [description]
Error Handling
If prerequisites are not met, report clearly which requirement failed.
Resources
Additional documentation can be found in the references/ directory.
Source
git clone https://github.com/martinemde/skillet/blob/main/testdata/comprehensive-skill/SKILL.mdView on GitHub Overview
Comprehensive-skill is a test skill that bundles all optional frontmatter fields and workflow steps to validate the skillet CLI parsing and execution. It ensures environments with Git, Docker, and internet access are handled correctly and that output formatting is consistent.
How This Skill Works
Technically, the skill defines a complete set of frontmatter fields and a three-step workflow: verify environment prerequisites (git, docker, internet), execute the main task per user requirements, and generate a detailed report. It enforces a standardized output format and provides error handling guidance, mirroring the example Task/Status/Details blocks.
When to Use It
- CI pipeline validation for skillet parsing
- Local dev environment sanity check for prerequisites (git, docker, internet)
- Educational/demo of frontmatter features and workflow steps
- Documentation QA for the Output Format and error handling sections
- Prerequisite-missing scenario testing and error reporting
Quick Start
- Step 1: Initialize — check versions with git --version and docker --version
- Step 2: Execute — run the main task according to user requirements
- Step 3: Report — provide a detailed summary of actions taken and format as in the example
Best Practices
- Run in an isolated environment that mirrors the stated prerequisites (Git, Docker, internet access)
- Validate that all optional frontmatter fields present in the SKILL.md are parsed correctly
- Use the provided Output Format block to verify consistent Task/Status/Details reporting
- Execute Step 1-3 with representative user requirements to exercise the workflow
- Test explicit error paths when prerequisites are not met and ensure clear failure messages
Example Use Cases
- A CI job runs comprehensive-skill to validate full SKILL.md parsing across a new skillet release
- A local development session confirms git and docker are installed and accessible before running any skillet tasks
- Documentation QA passes that validate the Output Format and Error Handling sections render correctly
- An educational demo shows how Step 1-3 map to real commands in a frontmatter-rich skill
- A test harness includes a prerequisites-missing scenario to verify clear error reporting
