Kapso
Leeroo-AI/kapso
Optimize code using KAPSO (Knowledge-Grounded Optimization).
The analyst has assigned you a research cycle, or you have identified a metric you want to improve through systematic experimentation.
$ npx skills add grandamenium/cortextos --skill autoresearch -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install grandamenium/cortextos autoresearch --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/grandamenium/cortextos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/community/skills/autoresearch .claude/skills/autoresearch && 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 "autoresearch" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/autoresearch into .claude/skills/autoresearch/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "autoresearch", 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/grandamenium/cortextos/tree/main/community/skills/autoresearchType 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 grandamenium/cortextos --skill autoresearch -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install grandamenium/cortextos autoresearch --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .agents/skills && cp -r skills-src/community/skills/autoresearch .agents/skills/autoresearch && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "autoresearch" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/autoresearch into .agents/skills/autoresearch/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "autoresearch", 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 grandamenium/cortextos --skill autoresearch -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install grandamenium/cortextos autoresearch --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/community/skills/autoresearch .cursor/skills/autoresearch && 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 "autoresearch" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/autoresearch into .cursor/skills/autoresearch/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "autoresearch", 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/grandamenium/cortextos.git --path community/skills/autoresearch--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 grandamenium/cortextos --skill autoresearch -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install grandamenium/cortextos autoresearch --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/community/skills/autoresearch .gemini/skills/autoresearch && 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 "autoresearch" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/autoresearch into .gemini/skills/autoresearch/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "autoresearch", 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 grandamenium/cortextos autoresearchInstalls 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 grandamenium/cortextos --skill autoresearch -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .github/skills && cp -r skills-src/community/skills/autoresearch .github/skills/autoresearch && 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 "autoresearch" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/autoresearch into .github/skills/autoresearch/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "autoresearch", 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 grandamenium/cortextos --skill autoresearch -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install grandamenium/cortextos autoresearch --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/community/skills/autoresearch .opencode/skills/autoresearch && 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 "autoresearch" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/autoresearch into .opencode/skills/autoresearch/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "autoresearch", 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.
autoresearchThe analyst has assigned you a research cycle, or you have identified a metric you want to improve through systematic experimentation.
Autoresearch is an agent skill from grandamenium/cortextos. The analyst has assigned you a research cycle, or you have identified a metric you want to improve through systematic experimentation. You will form a hypothesis, make a targeted change, measure the outcome against a baseline, and decide whether to keep or discard the change. You repeat this loop until the metric improves or you exhaust viable hypotheses. This is not ad-hoc research — it is structured scientific iteration with a defined metric, a hypothesis, and a measurable result.
Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Agent Workflows, covering Autonomous loops and A/B testing. The licence is MIT.
6 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 6f93838. 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.
Shell commands in SKILL.md call:
jqbashFrom 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 no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Autoresearch loads about 1.9k tokens when it runs. Until then it costs about 125 tokens; SKILL.md has 665 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 grandamenium/cortextos at commit 6f93838, republished under its MIT licence (© grandamenium). 665 words, ~1,927 tokens.
.claude/skills/autoresearch/SKILL.md (or your agent's skills folder).You are a scientist. Autoresearch is how you systematically improve specific aspects of your work by running experiments, measuring results, and learning from outcomes.
You have research cycles assigned to you (check experiments/config.json). Each cycle has:
You cannot autonomously modify your own cycle configuration. If the user asks you to modify a cycle, you can. Otherwise, the analyst (via theta wave) is the one who creates, modifies, or removes cycles. You CAN and SHOULD run experiments within your assigned cycles.
When your experiment cron fires, execute these steps:
cortextos bus gather-context --agent $CTX_AGENT_NAME --format markdownRead the output carefully. Pay attention to:
If there is an active experiment (check experiments/active.json):
cortextos bus evaluate-experiment <experiment_id> <measured_value> --justification "Why this result makes sense"For qualitative metrics, use --score <1-10> with a written justification.
Based on accumulated learnings:
Exploit vs Explore: If something has been kept 3+ times in a row, exploit that pattern further. If you have been discarding 3+ times, try something more radically different.
cortextos bus create-experiment "<metric_name>" "<your hypothesis>" --surface <path> --direction <higher|lower> --window <duration>If approval_required is true in experiments/config.json, you must manually create an approval before proceeding:
APPR_ID=$(cortextos bus create-approval "Run experiment: <hypothesis>" experiments "Cycle: <cycle_name>, Metric: <metric_name>, Surface: <surface>")
cortextos bus send-telegram $CTX_TELEGRAM_CHAT_ID "Approval needed to run experiment for <metric_name> — check dashboard"
# Block until approved, then continue to Step 5Apply your hypothesized changes to the surface file. Then:
cortextos bus run-experiment <experiment_id> "Description of what you changed"This creates a git commit with your changes (the experiment commit) so they can be cleanly reverted if the experiment fails.
The cycle ends. Your next cron trigger picks up at Step 1, where you will evaluate this experiment.
A script returns a number. Example: API scrape for engagement rate.
bash connectors/measure-instagram.sh
# Output: metric_value: 3.2You calculate from existing data. Example: task completion rate.
COMPLETED=$(cortextos bus list-tasks --agent $CTX_AGENT_NAME --status completed | jq length)
TOTAL=$(cortextos bus list-tasks --agent $CTX_AGENT_NAME | jq length)
RATE=$(echo "scale=2; $COMPLETED / $TOTAL * 100" | bc)You evaluate output quality on a 1-10 scale. You MUST write a justification.
cortextos bus evaluate-experiment <id> 0 --score 7 --justification "Output is more concise and actionable than baseline, but loses some nuance"You compare baseline vs experiment output side by side and score 1-10.
If the user asks you to set up autoresearch, collect these 8 things:
experiments/surfaces/engagement/current.md for a prompt, or SOUL.md for behavior)24h, 48h)Then create the cycle and surface directory:
# Create surface directory and baseline file
mkdir -p "experiments/surfaces/<metric>"
cat > "experiments/surfaces/<metric>/current.md" << 'EOF'
# <metric> — Baseline
[Describe the current approach being tested]
EOF
# Register the cycle
cortextos bus manage-cycle create $CTX_AGENT_NAME \
--cycle "<metric_name>" \
--metric "<metric_name>" \
--metric-type "<quantitative|qualitative>" \
--surface "experiments/surfaces/<metric>/current.md" \
--direction "<higher|lower>" \
--window "<e.g. 24h>" \
--measurement "<how to measure>" \
--loop-interval "<e.g. 48h>"
# Update approval setting in config if needed (default is true)
# Only set to false if user explicitly says no approval neededThen add the experiment cron via the bus (persistent across restarts):
cortextos bus add-cron $CTX_AGENT_NAME experiment-<metric> <loop_interval> "Read .claude/skills/autoresearch/SKILL.md and execute the experiment loop."To modify a cycle when the user asks:
cortextos bus manage-cycle modify $CTX_AGENT_NAME --cycle "<name>" \
--window "<new>" \
--loop-interval "<new>" \
--enabled <true|false>Use --enabled false to pause a cycle without deleting it.
© grandamenium, MIT. 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 community/skills/autoresearch of grandamenium/cortextos.
Open the folder on GitHubat commit 6f93838
Autoresearch 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 |
|---|---|---|---|---|---|---|
| Autoresearch this skillgrandamenium/cortextos | 101 | — | ~1.9k | Automated safety check: Pass | MIT | |
| KapsoLeeroo-AI/kapso | 121 | — | ~642 | Automated safety check: Pass | MIT | |
| Autoresearchericosiu/ai-marketing-skills | 3.6k | 2 repos | ~2.2k | Automated safety check: Pass | MIT | |
| Autoresearchgithub/awesome-copilot | 40k | 1 repos | ~2.8k | Automated safety check: Pass | MIT | |
| Edt MCP Tool DescriptionsDitriXNew/EDT-MCP | 296 | — | ~3k | Automated safety check: Pass | AGPL-3.0 | |
| Evo MemoryEvoScientist/EvoSkills | 478 | 3 repos | ~4.8k | Automated safety check: Pass | Apache-2.0 |
Leeroo-AI/kapso
Optimize code using KAPSO (Knowledge-Grounded Optimization).
ericosiu/ai-marketing-skills
Run Karpathy-style autoresearch optimization on any content.
github/awesome-copilot
Autonomous iterative experimentation loop for any programming task.
DitriXNew/EDT-MCP
How to size, write and A/B-test the text of a tool — its description and its inputSchema parameter prose — so that cutting it does not cost call quality, and so that a tool that IS getting called…
EvoScientist/EvoSkills
Manages persistent research memory across ideation and experimentation cycles.
leo-kuang-ai/spec-first
Run metric-driven iterative optimization loops. An agent skill from leo-kuang-ai/spec-first.
grandamenium/cortextos
Diagnose cortextOS itself when the framework misbehaves — an agent has gone silent or wedged, agents are crash-looping, Telegram or agent-to-agent messages are not arriving, crons did not fire, an…
grandamenium/cortextos
You have completed something significant and want the whole org — all agents and the user — to know about it.
grandamenium/cortextos
You need to make a purchase on behalf of the user — buy a SaaS subscription, pay for an API, purchase a domain, or any transaction requiring a credit card.
grandamenium/cortextos
Migrate ANY cortextOS agent from the claude-code runtime to the live codex-app-server runtime.
grandamenium/cortextos
Complete cortextos bus CLI reference - all available commands with examples.
grandamenium/cortextos
Daily cron-driven scan of news/forums/social in a domain to surface market shifts, new competitors, regulatory changes, and net-new opportunities.
Categories
The analyst has assigned you a research cycle, or you have identified a metric you want to improve through systematic experimentation. Autoresearch is an agent skill from grandamenium/cortextos. The analyst has assigned you a research cycle, or you have identified a metric you want to improve through systematic experimentation.
Autoresearch fits situations like: tasks that involve Autonomous loops; tasks that involve A/B testing.
Run `npx skills add grandamenium/cortextos --skill autoresearch -a claude-code`. Or copy the skill folder (community/skills/autoresearch in grandamenium/cortextos) into .claude/skills/autoresearch in your project. Claude Code loads it when a task matches its description.
Run `npx skills add grandamenium/cortextos --skill autoresearch -a codex`. Or copy the skill folder (community/skills/autoresearch in grandamenium/cortextos) into .agents/skills/autoresearch 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 grandamenium/cortextos --skill autoresearch -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/autoresearch, .gemini/skills/autoresearch, .github/skills/autoresearch and .opencode/skills/autoresearch in your project.
Going by SKILL.md and its folder, Autoresearch needs the command-line tools its instructions call (jq and bash).
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.
Autoresearch is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.9k tokens (SKILL.md is roughly 7.7k 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 Autoresearch: Kapso (Leeroo-AI/kapso, 121 stars), Autoresearch (ericosiu/ai-marketing-skills, 3.6k stars), Autoresearch (github/awesome-copilot, 40k stars) and Edt MCP Tool Descriptions (DitriXNew/EDT-MCP, 296 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
grandamenium (a GitHub user) maintains it in grandamenium/cortextos, which has 101 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on September 23, 2026.
Source: grandamenium/cortextos on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.