v4.0.0 completed the skill library. This release makes the project something you install.
Installation
First class targets for Claude Code and Codex, at user or project scope, from one reviewed skill source.
pip install social-cc-plugin
social-cc install --client claude-code --scope project--client and --scope select the target. diff shows what an install or upgrade would change before it changes it. upgrade and uninstall are supported operations rather than manual directory surgery.
Your files are not collateral
Installs are tracked by ownership manifests, so the installer knows what it put there and what you did.
- Unmanaged and locally modified skill directories are protected by default.
- The installer no longer recursively deletes an existing skill directory without ownership evidence.
- Forced replacement and removal preserve the prior directory under
.social-cc/backups/.
The Social Scientist Agent
A canonical agent definition with generated adapters for each client, plus repository guidance for Codex through AGENTS.md. Adapters are generated from the canonical source and checked for drift in CI, so they cannot quietly diverge.
Claims are checked, not asserted
Three validators run in CI:
- Release truth rebuilds the release facts from the repository and compares them against
meta/release.json. Every version surface must agree. - Agent parity confirms the generated adapters match the canonical source.
- Action pins confirm every third party GitHub Action is pinned to a full commit SHA.
There is also a synthetic research project and a bilingual evaluation corpus: 192 generated routing cases and 18 agent scenarios.
Release facts
33 booklets, 66 Turkish and English language files, 14 categories, 32 reviewed skills, 566 verified citation declarations, 0 fabricated citation declarations.
A declaration count is not a count of unique sources. Release facts are governed by meta/release.json and rebuilt from the repository by scripts/validate-release-truth.mjs.
Documentation
Platform architecture, client integration, skill responsibility, security and privacy, and a learning path.
Note on citation
The Zenodo concept DOI 10.5281/zenodo.20289687 resolves to the latest archived version and is the right thing to cite. Per-release version DOIs are recorded in CITATION.cff; the v5.0.0 version DOI is added there once Zenodo mints it from this release.
Prose remains CC BY-NC-SA 4.0; code remains Apache-2.0. See LICENSING.md.