gog-youtube

YouTube operations through gog.

Quality

59%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/gog-youtube/SKILL.md

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a clean, token-efficient overview that gives executable starting commands, clear safety guidance for writes, and a well-structured command map. Its main limitation is that per-command invocation examples are delegated to --help/schema rather than shown inline.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence: a compact safe-start block, a tight commands table, and a one-line delegation to `--help`/`schema` for details, with no padded explanation of what YouTube or gog is, matching the score-5 anchor 'Lean and efficient; every token earns its place'.	5 / 5
Actionability	Concrete executable commands are given (`gog auth list --check --json --no-input`, `gog --readonly --account user@example.com youtube --help`) plus specific flag guidance, but the commands table lists bare subcommand names without example invocations, leaving minor gaps consistent with the score-4 anchor.	4 / 5
Workflow Clarity	The Safe start is a clear three-step sequence (auth check, schema, help) and write safety provides explicit checkpoints (confirm account/object/mutation, `--dry-run`, `--readonly`), so the destructive-cap is avoided; it stops short of score 5 because there is no validate->fix->retry feedback loop.	4 / 5
Progressive Disclosure	This under-50-line skill is well-organized into Safe start and Commands sections, and its single external reference (`../gog/SKILL.md` for shared auth/output/safety rules) is clearly signaled and exactly one level deep, matching the score-5 simple-skill anchor.	5 / 5
	Total	18 / 20 Passed

Description

32%Weight 40%Scale 1-5

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 terse and names a distinct niche (YouTube via gog), but it is too vague about capabilities and entirely lacks a 'Use when...' trigger clause. It reads more as a label than an activation guide.

Suggestions

Add a 'Use when...' clause stating concrete triggers, e.g. 'Use when the user asks to search, list, or manage YouTube videos, channels, playlists, comments, or subscriptions.'

Replace the generic word 'operations' with 2-3 concrete actions (e.g., 'Search, list, and manage YouTube videos, channels, playlists, and comments via gog').

Include natural synonyms/file-style trigger terms users would actually say (videos, channel, playlist, comments) to improve trigger-term quality.

Dimension	Reasoning	Score
Specificity	The phrase "YouTube operations" names the domain but "operations" is generic with no concrete actions listed (e.g., no upload, search, list, manage), matching the score-2 anchor 'Names the domain but actions are minimal or generic'.	2 / 5
Completeness	It gives a vague 'what' ("YouTube operations through gog") and no 'when'/Use-when clause at all, matching the score-2 anchor 'Has a vague what and no when'; the missing trigger guidance also caps completeness below 4.	2 / 5
Trigger Term Quality	"YouTube" is a natural term, but it is paired with the generic "operations" and the technical jargon "gog"; common variations a user would say (videos, channels, playlists, comments) are absent, fitting the score-2 anchor of one or two generic/technical keywords missing natural phrases.	2 / 5
Distinctiveness Conflict Risk	"YouTube ... through gog" carves a clear, narrow niche that would rarely collide with unrelated skills, fitting the score-4 anchor 'Mostly distinct; minor overlap risk'; it does not reach 5 because no explicit trigger phrases reinforce the niche.	4 / 5
	Total	10 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 1 missing	Warning

	Total	15 / 16 Passed

Repository: openclaw/gogcli
Path: .agents/skills/gog-youtube/SKILL.md
Commit: eb85a99

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.