Home / kunchenguid / compact-adviser · packages/codex-plugin/skills/compact-adviser/SKILL.md · GitHub

compact-adviser skillA

compact-adviser is agent-read markdown (skill) from kunchenguid/compact-adviser: Read or change compact-adviser settings for Codex - the mode (hint or off), the minimum context before a checkpoint is judged, TypeSafe request logging, and the TypeSafe API key. Use when the user asks about compaction advice, the /compact hint, compact-adviser status, or wants to turn the adviser on or off..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# compact-adviser settings

compact-adviser watches for a completed checkpoint and prints one hint to run `/compact`.
It cannot run `/compact` itself: Codex exposes no way for an outside process to do that, so
this host is hint-only and there is no automatic mode. Never claim otherwise.

## How to run it

Settings live in a small CLI inside this plugin. From the directory that holds this
`SKILL.md`, the CLI is at `../../src/cli.ts`; run it with the absolute path:

```bash
node "<this skill's directory>/../../src/cli.ts" <command>
```

macOS or Linux and Node 22.18 or newer are required, because the CLI is TypeScript that Node strips types from and the hooks run through POSIX `sh`.

## Commands

| Command | Effect |
| --- | --- |
| `status` | Mode, minimum, key source, the latest session's cooldown, and the request-log path |
| `hint` | Advise with a hint at eligible checkpoints (the default) |
| `off` | Stop advising; Codex's own compaction is unaffected |
| `threshold <tokens\|default>` | Save an absolute token minimum |
| `log <on\|off>` | Log each TypeSafe request and its outcome to a local jsonl file |
…

Read the whole file at its exact version.

How to install

Latest version
mdr add kunchenguid/compact-adviser/compact-adviser@git:20260918.17e441a
Exact content
mdr add kunchenguid/compact-adviser/compact-adviser@sha256:55389ade92a15720

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_panjshqxz6taoxbg.svg)](https://markdownregistry.com/a/art_panjshqxz6taoxbg)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260918.17e441a latest2026-09-18 17e441a 1,844 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (1844 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kunchenguid/compact-adviser · 183 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_panjshqxz6taoxbg
GET https://markdownregistry.com/api/v1/resolve?ref=kunchenguid/compact-adviser/compact-adviser
GET https://markdownregistry.com/api/v1/blob/55389ade92a157200c9cb75acb6c8472fea5540ebbbbe6767659f6375587f227

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from kunchenguid/compact-adviser

codex-adapter skill
kunchenguid/compact-adviser · .agents/skills/codex-adapter/SKILL.md · Use when modifying or testing `packages/codex-plugin` or Codex `/compact` behavior.
git:20260920.d1655fa · audit A · 183 stars
judge-evaluation skill
kunchenguid/compact-adviser · .agents/skills/judge-evaluation/SKILL.md · Use when changing or evaluating judge prompts, scoring thresholds, usage floors, or judgment eval corpora.
git:20260920.d1655fa · audit A · 183 stars
AGENTS.md agents
kunchenguid/compact-adviser · AGENTS.md
git:20260923.6f06d04 · audit A · 183 stars
CLAUDE.md claude
kunchenguid/compact-adviser · CLAUDE.md
git:20260918.7e7095e · audit B · 183 stars

Every file in kunchenguid/compact-adviser

Browse by kind, by grade A, or by owner.