apple-media
Control Apple TV, HomePod, and AirPlay devices via pyatv (scan, stream, playback, volume, navigation).
Install with Tessl CLI
npx tessl i github:Demerzels-lab/elsamultiskillagent --skill apple-media75
Quality
68%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Optimize this skill with Tessl
npx tessl skill review --optimize ./public/skills/aaronn/apple-media/SKILL.mdDiscovery
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 excels at specificity and distinctiveness by naming concrete Apple devices, the pyatv tool, and specific actions. However, it critically lacks any 'Use when...' guidance, which is essential for Claude to know when to select this skill from a large pool. The trigger terms could also be expanded to include more natural user language.
Suggestions
Add a 'Use when...' clause with explicit triggers like 'Use when the user wants to control Apple TV, HomePod, stream media to AirPlay devices, or manage home entertainment systems'
Include more natural user phrases as trigger terms such as 'play music on', 'control my TV', 'media playback', 'smart home', or 'remote control'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'scan, stream, playback, volume, navigation' and names specific device types (Apple TV, HomePod, AirPlay devices) with the tool used (pyatv). | 3 / 3 |
Completeness | Describes what it does (control devices via pyatv with various actions) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes good device-specific terms (Apple TV, HomePod, AirPlay) and action terms (stream, playback, volume), but missing common user phrases like 'play music', 'control TV', 'media control', or 'smart home'. | 2 / 3 |
Distinctiveness Conflict Risk | Very clear niche targeting Apple ecosystem devices specifically via pyatv; unlikely to conflict with other skills due to the specific device names and protocol mentioned. | 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 well-crafted command reference skill that excels at conciseness and actionability. Every command is executable and the organization is logical. The main weakness is the lack of explicit workflow guidance for first-time setup (scan → pair → verify → control) which could help users avoid common pitfalls.
Suggestions
Add a 'Getting Started' workflow section at the top showing the sequence: 1) Scan for devices, 2) Pair if needed (check pairing status), 3) Verify with a simple command like 'playing', 4) Begin control
Include a validation step after pairing to confirm credentials were stored correctly (e.g., run a test command and check for errors)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, presenting commands directly without explaining what Apple TV or AirPlay is. Every section provides actionable commands with minimal commentary, and the setup notes address only non-obvious compatibility issues. | 3 / 3 |
Actionability | All commands are copy-paste ready with concrete examples. Each section provides executable bash commands with clear parameter syntax and realistic values like device names and IP addresses. | 3 / 3 |
Workflow Clarity | While individual commands are clear, the skill lacks explicit workflow sequencing for common multi-step tasks (e.g., scan → pair → control). The pairing section mentions it's required but doesn't integrate it into a clear first-time setup workflow with validation steps. | 2 / 3 |
Progressive Disclosure | Content is well-organized into logical sections (Playback, Volume, Navigation, etc.) with clear headers. For a reference-style skill of this scope, the flat structure with categorized commands is appropriate and easy to navigate. | 3 / 3 |
Total | 11 / 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 | |
- 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.