coder-xieshijie/dev-skills / skills/repo-readiness
repo-readiness
Verified| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.8 KB |
| agents/openai.yaml | config | 171 B |
| assets/feature-map.template.md | markdown | 1.5 KB |
| references/adapters/README.md | markdown | 1.7 KB |
| references/adapters/_page.mjs | script | 3.1 KB |
| references/adapters/_process.mjs | script | 8.3 KB |
| references/adapters/cli.mjs | script | 13.4 KB |
| references/adapters/http-service.mjs | script | 11.1 KB |
| references/adapters/test/cli.test.mjs | script | 9.3 KB |
| references/adapters/test/contract.test.mjs | script | 2.2 KB |
| references/adapters/test/fixture/toy-app.mjs | script | 2.3 KB |
| references/adapters/test/fixture/toy-cli.mjs | script | 2.6 KB |
| references/adapters/test/http-service.test.mjs | script | 6.2 KB |
| references/adapters/test/page.test.mjs | script | 6.7 KB |
| references/control-contract.md | markdown | 14.6 KB |
| references/counterexamples.md | markdown | 2.7 KB |
| references/lessons.md | markdown | 7.5 KB |
| references/levels.md | markdown | 4.0 KB |
| references/map-audit.md | markdown | 2.7 KB |
| references/route.md | markdown | 4.8 KB |
references/adapters/README.md
View on GitHub# Example entry adapters
Read these when writing an entry adapter for a repository. They are working examples, not part of the kit: copy one into the repository's `scripts/entries/` (with the `_` files it imports) and change what the product needs, or write your own. Either way, the kit's contract test (`scripts/test/contract.test.mjs`) holds the adapter to [control-contract.md](../control-contract.md).
| File | What it is |
|---|---|
| [http-service.mjs](http-service.mjs) | an app driven over HTTP: one process on a free port, identity proven by health (run ID, spawned pid or a per-run token), `api`, strict `read`, a `page` tool and `capture` for web pages |
| [cli.mjs](cli.mjs) | a command-line program: no long-lived process; `cli`, strict `query`, file reads inside the instance, and `down` that stops what commands left running (process groups and the pids the product records) |
| [_process.mjs](_process.mjs) | shared by both: the instance's directories and environment allowlist (own HOME and TMPDIR), placeholders, free ports, build freshness, and stopping only processes that name the instance's data directory |
| [_page.mjs](_page.mjs) | a page opened in a headless browser with Playwright: visible text and a full-page screenshot |
The header of each adapter documents its options. They import nothing from the kit: evidence errors are plain errors thrown inside `ctx.read`, which turns them into unreadable evidence.
In this repository, `test/` runs the contract test on each example with the toy products in `test/fixture/`, plus tests of the options the contract does not cover. Those tests import the kit from `assets/verify-skill/`, so they run here, not in a copy.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |