CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spinning-up-deep-rl

Learn or apply deep reinforcement learning with OpenAI Spinning Up: policy gradients, VPG, PPO, SAC, TD3, DDPG, TRPO. Use whenever an RL agent will not learn, reward stays flat, or the user asks how PPO or SAC works.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 body is an exemplary dense overview layer: lean curated frameworks with no padding, concrete operational guidance, unambiguous usage routing with a read-before-answering guardrail, and a well-designed two-tier reference structure (overview + 20 chapter files + topic index). The main defect is that the referenced bundle files are absent from the reviewed bundle, leaving the otherwise-excellent navigation unverifiable.

Suggestions

Ensure the referenced chapter files (chapters/ch01-... through ch20-...) and supporting files (glossary.md, patterns.md, cheatsheet.md) ship with the bundle so every link in the Chapter Index and Supporting Files sections resolves.

For Topic Index entries that map to multiple chapters (e.g., 'DDPG ch17, ch03, ch08'), mark the primary chapter or state the resolution order so routing is fully deterministic.

DimensionReasoningScore

Conciseness

Quotes: "pi* = argmax_pi J(pi), where J(pi) = E_{tau~pi}[R(tau)]" and "a [N] vs [N,1] shape mismatch is broadcast-compatible, raises nothing, and silently turns the Bellman backup into an [N,N] matrix" — the body is dense, curated study notes with no padding, no basic-concept teaching, and compact notation throughout, matching the level-5 anchor ("Lean and efficient; assumes Claude's competence; every token earns its place"). It is not a 4 because there is no filler to trim: time-sensitive details ("as of the January 2020 PyTorch update", "after early 2020") are properly quarantined in the Scope & Limits section, and the only metadata lines are MIT-attribution requirements.

5 / 5

Actionability

Quotes: "VPG, DQN, A2C, PPO, DDPG, roughly in that order; ~250-300 lines each", "under 5 minutes turnaround at the debug stage", "at least 3 seeds, 10 or more to be thorough", and the invocation examples ("/cs-spinning-up-deep-rl ch09") — concrete, specific guidance with real commands, matching the level-4 anchor ("Mostly executable guidance; concrete code or commands with minor gaps"). It is not a 5 because, as an instruction/study skill, it contains no executable code implementing the algorithms it teaches, leaving the "copy-paste ready" standard unmet even though the scoring notes say code absence is not penalized if guidance is actionable.

4 / 5

Workflow Clarity

Quotes: "No argument — load the core frameworks", "A topic — ask about... I resolve it through the Topic Index and read that chapter file", and the guardrail "I read the relevant chapter file before answering rather than guessing" — the routing workflow is clearly sequenced with an explicit verify-before-answering checkpoint, matching the level-4 anchor ("Clear sequence with most checkpoints present; minor validation gaps"). It is not a 5 because multi-chapter topics (e.g., "DDPG ch17, ch03, ch08") lack guidance on which chapter is primary, and no feedback loop exists for the case where a resolved topic does not match the user's intent.

4 / 5

Progressive Disclosure

Quotes: the Chapter Index table linking "[ch01](chapters/ch01-introduction.md)" through ch20, the Topic Index with 38 navigable entries, and "[glossary.md](glossary.md) · [patterns.md](patterns.md) · [cheatsheet.md](cheatsheet.md)" — a clear overview with well-signaled, one-level-deep references. However, none of the referenced bundle files (chapters/*.md, glossary.md, patterns.md, cheatsheet.md) are present in the reviewed bundle, so the links cannot be verified as real; this drops it from the level-5 anchor ("easy navigation" to files that actually exist) to level-4 ("references mostly clear; minor organization gaps"). It is not a 3 because the structure and signaling themselves are exemplary: overview content stays inline, details are split into per-chapter files, and navigation is via explicit labeled links.

4 / 5

Total

17

/

20

Passed

Description

87%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 clearly and explicitly answers both what the skill does and when to use it, with concrete trigger phrases that mirror real user language about RL failure modes. Keyword coverage is strong with only minor synonym gaps, and the deep-RL/Spinning Up niche makes conflict risk minimal.

DimensionReasoningScore

Specificity

Quotes: "Learn or apply deep reinforcement learning with OpenAI Spinning Up: policy gradients, VPG, PPO, SAC, TD3, DDPG, TRPO" — it names the domain, the source, and seven specific algorithms, matching the level-4 anchor ("Lists several specific actions; minor gaps in coverage"). It is not a 3 because coverage goes well beyond 1-2 concrete items, and not a 5 because the action verbs ("learn or apply") are generic compared to concrete operations like "extract" or "fill forms".

4 / 5

Completeness

Quotes: "Learn or apply deep reinforcement learning with OpenAI Spinning Up: policy gradients, VPG, PPO, SAC, TD3, DDPG, TRPO" (clear what) and "Use whenever an RL agent will not learn, reward stays flat, or the user asks how PPO or SAC works" (explicit when with concrete trigger phrases). This directly matches the level-5 anchor; the explicit "Use whenever" clause also avoids the level-3 cap for missing trigger guidance.

5 / 5

Trigger Term Quality

Quotes: "an RL agent will not learn, reward stays flat, or the user asks how PPO or SAC works" — these are natural phrases users would actually say, plus algorithm names (PPO, SAC, DDPG, TRPO) that directly match user vocabulary. This matches the level-4 anchor ("Good keyword coverage; a few natural terms missing"); it falls short of 5 because common variations like "converge", "train an agent", or "reward not improving" are absent.

4 / 5

Distinctiveness Conflict Risk

Quotes: "deep reinforcement learning with OpenAI Spinning Up" and the named algorithms (VPG, PPO, SAC, TD3, DDPG, TRPO) — a clear niche with distinct, unambiguous triggers tied to specific RL failure modes and algorithms. This matches the level-5 anchor ("Clear niche with distinct triggers; minimal conflict risk"); it is not a 4 because the algorithm-specific triggers are unlikely to fire for any other skill.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

relative_links

Relative link issues: 23 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

engineering/spinning-up-deep-rl/skills/spinning-up-deep-rl/SKILL.md

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.