Agents Best Practices
DenisSergeevitch/agents-best-practices
A skill your agent uses when designing, generating an MVP blueprint for, auditing, troubleshooting, refactoring, or explaining an agentic harness for any domain.
Runs the `autoctx` CLI to improve an approach to a task over several generations, score or refine a single output and inspect what a run produced.
$ npx skills add greyhaven-ai/autocontext --skill autocontext-creator -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install greyhaven-ai/autocontext autocontext-creator --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/greyhaven-ai/autocontext.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/autocontext-creator .claude/skills/autocontext-creator && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "autocontext-creator" agent skill from https://github.com/greyhaven-ai/autocontext/tree/main/skills/autocontext-creator into .claude/skills/autocontext-creator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "autocontext-creator", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/greyhaven-ai/autocontext/tree/main/skills/autocontext-creatorType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add greyhaven-ai/autocontext --skill autocontext-creator -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install greyhaven-ai/autocontext autocontext-creator --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/greyhaven-ai/autocontext.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/autocontext-creator .agents/skills/autocontext-creator && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "autocontext-creator" agent skill from https://github.com/greyhaven-ai/autocontext/tree/main/skills/autocontext-creator into .agents/skills/autocontext-creator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "autocontext-creator", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add greyhaven-ai/autocontext --skill autocontext-creator -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install greyhaven-ai/autocontext autocontext-creator --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/greyhaven-ai/autocontext.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/autocontext-creator .cursor/skills/autocontext-creator && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "autocontext-creator" agent skill from https://github.com/greyhaven-ai/autocontext/tree/main/skills/autocontext-creator into .cursor/skills/autocontext-creator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "autocontext-creator", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/greyhaven-ai/autocontext.git --path skills/autocontext-creator--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add greyhaven-ai/autocontext --skill autocontext-creator -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install greyhaven-ai/autocontext autocontext-creator --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/greyhaven-ai/autocontext.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/autocontext-creator .gemini/skills/autocontext-creator && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "autocontext-creator" agent skill from https://github.com/greyhaven-ai/autocontext/tree/main/skills/autocontext-creator into .gemini/skills/autocontext-creator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "autocontext-creator", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install greyhaven-ai/autocontext autocontext-creatorInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add greyhaven-ai/autocontext --skill autocontext-creator -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/greyhaven-ai/autocontext.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/autocontext-creator .github/skills/autocontext-creator && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "autocontext-creator" agent skill from https://github.com/greyhaven-ai/autocontext/tree/main/skills/autocontext-creator into .github/skills/autocontext-creator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "autocontext-creator", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add greyhaven-ai/autocontext --skill autocontext-creator -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install greyhaven-ai/autocontext autocontext-creator --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/greyhaven-ai/autocontext.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/autocontext-creator .opencode/skills/autocontext-creator && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "autocontext-creator" agent skill from https://github.com/greyhaven-ai/autocontext/tree/main/skills/autocontext-creator into .opencode/skills/autocontext-creator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "autocontext-creator", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
autocontext-creatorRuns the `autoctx` CLI to improve an approach to a task over several generations, score or refine a single output and inspect what a run produced.
Autocontext runs an improvement loop over a task and writes what it learns to disk. This skill covers producing that knowledge, while reading what already exists is left to `autocontext-consumer`. The only requirement is that the agent can run `autoctx` and read its output, so it is not tied to one host, and the agent passes `--json` whenever it will parse a result because the human-readable form is not a stable interface.
The commands covered are `autoctx run` on a named scenario with a number of iterations, each a generation that produces and scores a candidate, `autoctx solve` for a plain-language task, `autoctx judge` to score an output against a rubric and `autoctx improve` to iterate on one. A run can be given an id and then inspected with `list`, `status`, `show` and `replay`, or followed live with `watch`, and `scenario create` scaffolds a named scenario from a template. The excerpt ends before the provider section.
Read from SKILL.md and the folder at commit f72c154. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names these keys or tokens, usually read from environment variables:
AUTOCONTEXT_AGENT_API_KEYFrom names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Autocontext Knowledge Creator loads about 964 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 407 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from greyhaven-ai/autocontext at commit f72c154, republished under its Apache-2.0 licence (© greyhaven-ai). 407 words, ~964 tokens.
.claude/skills/autocontext-creator/SKILL.md (or your agent's skills folder).Autocontext runs an improvement loop over a task and writes what it learned to
disk. This skill covers producing that knowledge. To read knowledge that
already exists, use autocontext-consumer instead.
Nothing here assumes a particular agent host. The only requirement is that you
can run autoctx and read its output.
Do not use this skill to look up existing knowledge. That is autocontext-consumer.
--json When ParsingEvery command below accepts --json. Use it whenever you intend to read the
result programmatically; the human-readable form is not a stable interface.
autoctx run grid_ctf --iterations 3 --json--iterations is the number of generations. Each one produces a candidate, scores it,
and folds what it learned into the knowledge for that scenario.
Give the run an id you choose when you need to refer back to it:
RUN_ID="my_run_$(date +%s)"
autoctx run grid_ctf --iterations 3 --run-id "$RUN_ID" --json
autoctx status "$RUN_ID" --jsonWhen there is no scenario, describe the task:
autoctx solve "Improve the support-triage response policy." --iterations 3 --jsonFor one-shot work, without a loop:
autoctx judge --task-prompt "..." --output "..." --rubric "..." --json
autoctx improve --task-prompt "..." --rubric "..." --rounds 3 --jsonjudge scores an output you already have. improve iterates on it.
autoctx list --json
autoctx status "$RUN_ID" --json
autoctx show "$RUN_ID"
autoctx replay "$RUN_ID" --generation 1show renders the run's artifacts. replay prints the JSON for one generation,
which is the level to inspect when a score looks wrong.
autoctx watch "$RUN_ID"autoctx scenario create --list
autoctx scenario create --template content-generation --name support-contentScaffolds from the template library. Use this when the task recurs and deserves
a named scenario rather than a one-off solve.
Autocontext defaults to a hosted Anthropic model. To point it somewhere else, including a local server, set the provider before running:
export AUTOCONTEXT_AGENT_PROVIDER=openai-compatible
export AUTOCONTEXT_AGENT_BASE_URL=http://localhost:11434/v1
export AUTOCONTEXT_AGENT_API_KEY=no-key
export AUTOCONTEXT_LOCAL_MODEL=llama3.1
autoctx run grid_ctf --iterations 3 --jsonKeep secrets and base URLs in the environment or the user's profile, never in a skill file.
autoctx run preflights every endpoint it will use and refuses to start on a
dead endpoint, a rejected credential, or a model the server does not serve.
That check is why a misconfigured run fails in seconds rather than after
spending tokens. --skip-preflight exists but wastes that protection.
Runs write to the local knowledge root and stay there. Nothing is uploaded. Treat run artifacts as you would any local file containing the task text and model output - they contain whatever you put in the prompt.
© greyhaven-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/autocontext-creator of greyhaven-ai/autocontext.
Open the folder on GitHubat commit f72c154
Autocontext Knowledge Creator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Autocontext Knowledge Creator this skillgreyhaven-ai/autocontext | 1.3k | — | ~964 | Automated safety check: Pass | Apache-2.0 | |
| Agents Best PracticesDenisSergeevitch/agents-best-practices | 2.4k | — | ~7.4k | Automated safety check: Pass | MIT | |
| Clawpathy AutoresearchClawBio/ClawBio | 1.2k | — | ~1.4k | Automated safety check: Pass | MIT | |
| Looperksimback/looper | 710 | — | ~2.7k | Automated safety check: Notes | MIT | |
| Loop Architectfabricioctelles/skills | 106 | — | ~2.1k | Automated safety check: Notes | MIT | |
| Autoresearchbyungjunjang/jangpm-meta-skills | 120 | — | ~6k | Automated safety check: Warn | None |
DenisSergeevitch/agents-best-practices
A skill your agent uses when designing, generating an MVP blueprint for, auditing, troubleshooting, refactoring, or explaining an agentic harness for any domain.
ClawBio/ClawBio
Eval-driven skill tuning. An agent skill from ClawBio/ClawBio.
ksimback/looper
Scaffold a well-designed agent loop with best-practice coaching and a cross-model review council.
fabricioctelles/skills
Design well-structured agent loops with best-practice coaching and cross-model review gates before you run them.
byungjunjang/jangpm-meta-skills
Autonomously optimize a Claude Code skill or agent system by running it repeatedly, scoring outputs against evals, mutating owned artifacts (prompt, references, scripts, agent definitions), and…
leo-kuang-ai/spec-first
Run metric-driven iterative optimization loops. An agent skill from leo-kuang-ai/spec-first.
greyhaven-ai/autocontext
Lets a Hermes agent run Autocontext scenarios, inspect Hermes curator state, export reusable knowledge and prepare local MLX or CUDA training data through the autoctx CLI.
greyhaven-ai/autocontext
Runs LLM-based rubric judging on agent output and loops revise-and-rejudge rounds until a quality threshold is met.
greyhaven-ai/autocontext
Reads and moves the playbooks and lessons that Autocontext has already learned, using the autoctx CLI and plain files on disk.
greyhaven-ai/autocontext
Operational notes for generating, evaluating and debugging strategies in the autocontext grid_ctf scenario, with tier rules and parameter ranges that worked or failed.
Categories
Runs the `autoctx` CLI to improve an approach to a task over several generations, score or refine a single output and inspect what a run produced. Autocontext runs an improvement loop over a task and writes what it learns to disk. This skill covers producing that knowledge, while reading what already exists is left to `autocontext-consumer`.
Autocontext Knowledge Creator fits situations like: improving an approach to a recurring task over several generations; scoring one output against a rubric without running a full loop; inspecting what a finished Autocontext run produced.
Run `npx skills add greyhaven-ai/autocontext --skill autocontext-creator -a claude-code`. Or copy the skill folder (skills/autocontext-creator in greyhaven-ai/autocontext) into .claude/skills/autocontext-creator in your project. Claude Code loads it when a task matches its description.
Run `npx skills add greyhaven-ai/autocontext --skill autocontext-creator -a codex`. Or copy the skill folder (skills/autocontext-creator in greyhaven-ai/autocontext) into .agents/skills/autocontext-creator in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add greyhaven-ai/autocontext --skill autocontext-creator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/autocontext-creator, .gemini/skills/autocontext-creator, .github/skills/autocontext-creator and .opencode/skills/autocontext-creator in your project.
Going by SKILL.md and its folder, Autocontext Knowledge Creator needs credentials named AUTOCONTEXT_AGENT_API_KEY. Our summary lists: The `autoctx` command-line tool.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Autocontext Knowledge Creator is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 964 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Autocontext Knowledge Creator: Agents Best Practices (DenisSergeevitch/agents-best-practices, 2.4k stars), Clawpathy Autoresearch (ClawBio/ClawBio, 1.2k stars), Looper (ksimback/looper, 710 stars) and Loop Architect (fabricioctelles/skills, 106 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
greyhaven-ai (a GitHub organization) maintains it in greyhaven-ai/autocontext, which has 1,304 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.
Source: greyhaven-ai/autocontext on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.