inkjet
Print text, images, and QR codes to a wireless Bluetooth thermal printer from a MacOS device. Use `inkjet print` for output, `inkjet scan` to discover printers.
60
73%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./public/skills/aaronchartier/inkjet/SKILL.mdQuality
Discovery
82%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong, specific description that clearly identifies a narrow hardware-focused skill with concrete actions and good natural trigger terms. Its main weakness is the absence of an explicit 'Use when...' clause, which would help Claude know exactly when to select this skill over others. The specific CLI commands and hardware context make it highly distinctive.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user wants to print to a thermal printer, send output to a receipt printer, or discover nearby Bluetooth printers on MacOS.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: printing text, images, and QR codes to a Bluetooth thermal printer, and includes specific CLI commands ('inkjet print', 'inkjet scan') for output and discovery. | 3 / 3 |
Completeness | Clearly answers 'what' (print text/images/QR codes to a Bluetooth thermal printer, scan for printers) but lacks an explicit 'Use when...' clause describing when Claude should select this skill. The rubric caps completeness at 2 when this is missing. | 2 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'print', 'thermal printer', 'Bluetooth', 'QR codes', 'images', 'MacOS', 'scan', 'discover printers'. These cover the likely terms a user would use when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche: wireless Bluetooth thermal printer on MacOS with specific CLI tool names ('inkjet'). Very unlikely to conflict with other skills given the narrow hardware and platform scope. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, highly actionable skill with excellent concrete examples covering the full range of the `inkjet` CLI. Its main weaknesses are moderate verbosity (some sections explain more than needed) and a lack of explicit workflow sequencing with validation checkpoints, particularly around the Bluetooth discovery and connection process. The content would benefit from being split across files for the more advanced topics.
Suggestions
Add an explicit setup workflow with validation: 1. Turn on printer → 2. Run `inkjet scan` → 3. Verify printer appears in output → 4. Run `inkjet whoami` to confirm default is set → 5. Test with `inkjet print text "test"`
Move the Multi-Printer Orchestration, Configuration Tweaking (JSON), and Best Practices for Worksheets sections into separate referenced files to keep SKILL.md as a concise overview
Trim explanatory prose like 'Thermal paper is extremely low-cost, enabling high-frequency physical output' and 'The printer does NOT need to be paired to the host computer's Bluetooth settings; inkjet connects directly via BLE' — keep only the actionable constraint (no pairing needed)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient with good use of code examples, but includes some unnecessary explanations (e.g., 'Thermal paper is extremely low-cost, enabling high-frequency physical output', explaining what BLE is, the orchestration strategies section is somewhat verbose). The worksheets section and configuration tweaking section add bulk that could be tightened. | 2 / 3 |
Actionability | Excellent actionability throughout — every section provides concrete, copy-paste-ready CLI commands with realistic arguments. The examples cover text, markdown, images, QR codes, piping, multi-printer targeting, and configuration, all with executable commands. | 3 / 3 |
Workflow Clarity | The setup flow (scan → whoami → print) is implicit but not explicitly sequenced as a workflow. There's a troubleshooting section with `inkjet doctor` but no validation checkpoints between steps (e.g., confirming scan found a printer before printing). For a CLI tool that involves Bluetooth discovery, explicit verification steps would improve reliability. | 2 / 3 |
Progressive Disclosure | Content is well-organized with clear section headers progressing from basic to advanced usage. However, the file is quite long (~150 lines of substantive content) and sections like Configuration Tweaking, Multi-Printer Orchestration, and Best Practices for Worksheets could be split into separate reference files. No bundle files exist to offload to, but the monolithic structure could benefit from separation. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 8 / 11 Passed | |
- Repository
- Demerzels-lab/elsamultiskillagent
- Commit
f45fcb5
- 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.