claude-skills/engineering/spinning-up-deep-rl
Alireza Rezvani 40fa75258a
docs(book-to-skill): add attribution block to the compiled skill's sidecar
Addresses the review observation on #993: the compiled skill's
authoring-notes.json carried only a `source` block (how it was built) even
though its content is derived from an external MIT-licensed work, where the
rest of the repo uses an `attribution` block for that. check_plugin_json.py's
NOTES_ALLOWED permits both keys, so the two coexist.

Adds `attribution` to engineering/spinning-up-deep-rl following the shape used
by book-to-skill and skillopt-sleep: derived_from, upstream_docs, upstream_path,
original_author, original_license, original_copyright, derivation_note.

The emitter is deliberately NOT changed to synthesise this. It knows only
`--source-note` free text and a rights basis -- not an upstream URL, author or
licence -- and a half-filled attribution block is worse than none. Instead
Step 11 of conversion_workflow.md now says attribution is added by hand
whenever `--rights` is anything but internal-docs, names the field shape, and
restates that the actual obligation is the LICENSE notice and README credit --
authoring-notes.json is metadata Claude Code never reads, and a sidecar JSON
file is not a licence notice.

Gates re-run clean: check_plugin_json --all, check_paths, check_frontmatter,
check_dual_publish, check_model_freshness, smoke_scripts (692/692),
derive_counters --check, book_skill_validator --strict.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UySnyf5upm4y8xhYA3w6yw
2026-08-25 18:57:31 +00:00
..
.claude-plugin docs(book-to-skill): add attribution block to the compiled skill's sidecar 2026-08-25 18:57:31 +00:00
agents feat(engineering): compile OpenAI's Spinning Up in Deep RL into a knowledge-base plugin 2026-08-25 18:49:30 +00:00
commands feat(engineering): compile OpenAI's Spinning Up in Deep RL into a knowledge-base plugin 2026-08-25 18:49:30 +00:00
skills/spinning-up-deep-rl feat(engineering): compile OpenAI's Spinning Up in Deep RL into a knowledge-base plugin 2026-08-25 18:49:30 +00:00
LICENSE feat(engineering): compile OpenAI's Spinning Up in Deep RL into a knowledge-base plugin 2026-08-25 18:49:30 +00:00
README.md feat(engineering): compile OpenAI's Spinning Up in Deep RL into a knowledge-base plugin 2026-08-25 18:49:30 +00:00

Spinning Up in Deep RL

Knowledge-base plugin compiled from Spinning Up in Deep RL by Joshua Achiam (OpenAI) by engineering/book-to-skill. 20 chapters indexed.

What is in here

File Contents
skills/spinning-up-deep-rl/SKILL.md Core frameworks, chapter index, topic index (resident, under 4k tokens)
skills/spinning-up-deep-rl/chapters/ One summary per chapter — loaded on demand, never all at once
skills/spinning-up-deep-rl/glossary.md Every significant term, alphabetized, with its chapter
skills/spinning-up-deep-rl/patterns.md Techniques and design patterns with trade-offs
skills/spinning-up-deep-rl/cheatsheet.md Decision rules, thresholds and trade-off matrices

Use

/cs:spinning-up-deep-rl                    # core frameworks + chapter index
/cs:spinning-up-deep-rl <topic>            # resolve via topic index, read one chapter
/cs:spinning-up-deep-rl ch05               # read one chapter summary

Or invoke the cs-spinning-up-deep-rl agent for a working session anchored to this source.

Provenance and limits

Source: OpenAI's Spinning Up in Deep RL (openai/spinningup), primarily developed by Joshua Achiam. Compiled from the docs/ reStructuredText tree at the January 2020 PyTorch update.

Rights basis: open-license. The source is MIT, Copyright (c) 2018 OpenAI, which permits derivative distribution. The full upstream notice is reproduced in LICENSE alongside this package's own; the top-level license field in plugin.json covers the scaffolding only.

Generated, not hand-authored: every claim traces to the source document. It carries that source's blind spots, and it is a set of structured notes — not a copy of the work and not a substitute for reading it.

What it does not cover: DQN and the discrete-action value-learning family, recurrent or convolutional architectures, partially-observed settings, model-based implementations, and any deep RL work after early 2020. The six implementations documented are educational; ch13 records which are research-grade (DDPG, TD3, SAC) and which are not (VPG, TRPO, PPO).

Distribution: shareable. Regenerate or extend with python3 engineering/book-to-skill/skills/book-to-skill/scripts/extract_document.py, then re-run book_skill_validator.py before loading the result.