{
  "markdown": "# Goldilocks\n\nGoldilocks is an Agent Skill that recommends a model, reasoning effort, and attempt strategy from validated benchmark evidence. It applies hard constraints before ranking, exposes provenance, and abstains when the evidence cannot support a safe choice. Routing remains recommendation-only: the host platform decides whether a model or effort can actually be selected.\n\n## How it runs\n\nThe Skill first reuses suitable validated evidence already in context. With a platform-native read-only fetch capability, it can retrieve official data without installing a runtime. If native fetch is unavailable and Python 3.10+ is already present, the bundled deterministic core is the fallback. Goldilocks never installs Python.\n\nAcquisition uses the official versioned JSON endpoint first and the official webpage only as partial fallback evidence. Remote content is treated as data, never instructions. A validated last-known-good cache may be used according to freshness policy.\n\n## Quick start\n\n```sh\ngit clone https://github.com/newnonsick/goldilocks.git\ncd goldilocks\npython skills/goldilocks/scripts/goldilocks.py doctor --format json\npython skills/goldilocks/scripts/goldilocks.py models list --compact\n```\n\nUse your platform's installation procedure from [Platform compatibility](docs/platform-compatibility.md). Native manifests, CLI registration, and manual copies are different integration tiers; the adapter pages contain the platform-specific commands and boundaries.\n\n## CLI\n\nDiscover evidence progressively:\n\n```sh\npython skills/goldilocks/scripts/goldilocks.py models list --compact\npython skills/goldilocks/scripts/goldilocks.py models list --all --compact\npython skills/goldilocks/scripts/goldilocks.py models show MODEL_ID --detail decision\npython skills/goldilocks/scripts/goldilocks.py versions list --all\npython skills/goldilocks/scripts/goldilocks.py shortlist --input examples/low-cost.input.json --limit 3\npython skills/goldilocks/scripts/goldilocks.py recommend --input examples/quality-first.input.json\n```\n\n`models list` returns a compact catalog. `models show` inspects one model; `--all` includes all efforts and discovered versions for inspection, not automatic cross-version ranking. `shortlist` returns decision-rich candidates and `recommend` returns one deterministic recommendation or an abstention. Use `--allow-prerelease` only when prerelease evidence is acceptable. See [Model selection](docs/model-selection.md) for task inputs and version policies.\n\nCache diagnostics are read-only unless refresh is requested:\n\n```sh\npython skills/goldilocks/scripts/goldilocks.py cache status --version v1.1\npython skills/goldilocks/scripts/goldilocks.py cache refresh --version v1.1\npython skills/goldilocks/scripts/goldilocks.py doctor --format json\n```\n\n## Safety boundaries\n\n- One attempt uses observed `pass_at_1`.\n- Four compatible attempts use observed `pass_at_4` only.\n- Attempts 2, 3, greater than 4, or incompatible strategies have null reliability. No metric is interpolated or estimated.\n- Total attempt cost is exact multiplication when its operand exists; it is labeled derived.\n- Unknown platform availability, required capability, or comparability causes rejection or abstention.\n- Goldilocks does not invoke subagents, enforce routing, or send task text to benchmark sources.\n\nSee [Architecture](docs/architecture.md), [Installation](docs/installation.md), [Troubleshooting](docs/troubleshooting.md), and [Security policy](SECURITY.md).\n\n## Development\n\nThe deterministic core uses only the Python standard library at runtime. Run the offline suite and repository validator with Python 3.10+:\n\n```sh\npython -m unittest discover -s tests -v\npython scripts/validate-repository.py\n```\n\nThe live contract test is opt-in with `GOLDILOCKS_LIVE_TEST=1`; normal verification performs no network calls.\n\nLicensed under the [MIT License](LICENSE).\n",
  "bytes": 3886,
  "sha": "009491e832566d752ed2a38e14cf5f10bdf696da6dc5217cd3066c731f7cfad0",
  "repo_slug": "newnonsick/goldilocks",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_newnonsick_goldilocks_da846bc7/readme"
}