Darwin Skill Optimizer
alchaincyf/darwin-skill
Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.
Finds, rates, reviews, creates, improves, installs and syncs Agent Skill folders from local workspaces, registries or remote sources, with a user gate before any write.
Install Octocode Skills Manager
$ npx skills add bgauryy/octocode --skill octocode-skills -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install bgauryy/octocode octocode-skills --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/bgauryy/octocode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/octocode-skills .claude/skills/octocode-skills && 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 "octocode-skills" agent skill from https://github.com/bgauryy/octocode/tree/main/skills/octocode-skills into .claude/skills/octocode-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octocode-skills", 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/bgauryy/octocode/tree/main/skills/octocode-skillsType 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 bgauryy/octocode --skill octocode-skills -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install bgauryy/octocode octocode-skills --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bgauryy/octocode.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/octocode-skills .agents/skills/octocode-skills && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "octocode-skills" agent skill from https://github.com/bgauryy/octocode/tree/main/skills/octocode-skills into .agents/skills/octocode-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octocode-skills", 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 bgauryy/octocode --skill octocode-skills -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install bgauryy/octocode octocode-skills --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bgauryy/octocode.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/octocode-skills .cursor/skills/octocode-skills && 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 "octocode-skills" agent skill from https://github.com/bgauryy/octocode/tree/main/skills/octocode-skills into .cursor/skills/octocode-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octocode-skills", 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/bgauryy/octocode.git --path skills/octocode-skills--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 bgauryy/octocode --skill octocode-skills -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install bgauryy/octocode octocode-skills --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bgauryy/octocode.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/octocode-skills .gemini/skills/octocode-skills && 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 "octocode-skills" agent skill from https://github.com/bgauryy/octocode/tree/main/skills/octocode-skills into .gemini/skills/octocode-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octocode-skills", 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 bgauryy/octocode octocode-skillsInstalls 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 bgauryy/octocode --skill octocode-skills -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/bgauryy/octocode.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/octocode-skills .github/skills/octocode-skills && 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 "octocode-skills" agent skill from https://github.com/bgauryy/octocode/tree/main/skills/octocode-skills into .github/skills/octocode-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octocode-skills", 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 bgauryy/octocode --skill octocode-skills -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install bgauryy/octocode octocode-skills --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bgauryy/octocode.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/octocode-skills .opencode/skills/octocode-skills && 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 "octocode-skills" agent skill from https://github.com/bgauryy/octocode/tree/main/skills/octocode-skills into .opencode/skills/octocode-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "octocode-skills", 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.
Facts
- Skill name
octocode-skills- GitHub stars
- 949
- Token cost
- ~1.2k tokens
- SKILL.md length
- 515 words
- Files
- 38 (incl. scripts, references, assets)
- Skills in repo
- 12
- Repo updated
- First seen
- Licence
- MIT
At a glance
Finds, rates, reviews, creates, improves, installs and syncs Agent Skill folders from local workspaces, registries or remote sources, with a user gate before any write.
- Finding and comparing skills for a task from a registry or GitHub
- SKILL.md covers Lobby rules, Smart routes — load only what…, Related routes and Scripts and done gate, plus 1 more section
- Runs JavaScript and Shell scripts from its folder
- Reviewing or rating a SKILL.md for quality before installing it
What it does
The skill operates on standalone Agent Skill folders, meaning a SKILL.md with optional references, scripts and assets. It follows a fixed flow from understanding the request through discovery, inspection, judging and a recommendation to a user gate, and only then acts, cleans up, reviews and verifies. The real SKILL.md is inspected before quoting, judging or installing, and every write is gated.
Reference files are loaded by step: search playbooks, discovery surfaces and manifests for finding skills, quality rubrics and adoption signals for judging, anatomy, authoring and description-tuning guides for creating, and improvement and cleanup guides for repairing, plus install gates and destinations, remote fetching and hooks. Rankings weigh evidence rather than popularity alone, and the search stops once one fit is clear. Pure wording polish goes to the octocode-prompt-optimizer skill.
When your agent uses it
- Finding and comparing skills for a task from a registry or GitHub
- Reviewing or rating a SKILL.md for quality before installing it
- Creating or improving a local skill folder and tuning its description
- Installing or syncing skills with approval at each write
Example prompts
- “Find skills for database migrations and rank the best two with evidence.”
- “Review the skill in ./skills/api-docs and suggest improvements to its description.”
- “Install the chosen skill into my project, but show me its SKILL.md first.”
What it can do on your machine
Read from SKILL.md and the folder at commit c265e3f. It shows what the files ask for, not the result of running them.
Tool permissions
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.
Runs code
Ships 1 file in scripts/ (JavaScript and Shell, from the files we listed), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Octocode Skills Manager loads about 1.2k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 71 tokens; SKILL.md has 515 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.
Safety
Auto-check passed
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); the scripts in this folder are not scanned.
SKILL.md
The full file from bgauryy/octocode at commit c265e3f, republished under its MIT licence (© bgauryy). 515 words, ~1,200 tokens.
Download SKILL.mdSave it as
.claude/skills/octocode-skills/SKILL.md (or your agent's skills folder). This skill also uses 37 other files; get the full folder from GitHub.- name
- octocode-skills
- description
- Use when working on Agent Skills (SKILL.md folders): find, compare, rate, review, create, improve, repair, install, or sync skills from local workspaces, registries, or remote sources. For wording-only prompt polish without folder ops, use octocode-prompt-optimizer.
Octocode Skills
Operate on standalone Agent Skill folders: SKILL.md plus optional references, scripts, and assets.
Flow: UNDERSTAND → DISCOVER → INSPECT → JUDGE → RECOMMEND → USER GATE → ACT → CLEANUP → REVIEW → VERIFY.
Lobby rules
SKILL.mdowns workflows, hard gates, and routes; each reference owns one concept and never restates the flow.- The lobby lists every reference and every script with when and how to use it, plus the workflows — no chunk is discoverable only by opening another file.
- MUST read and navigate between routed reference files to understand the complete flow; this skill is intentionally simplified into reference units for efficiency, including reference-to-reference handoffs.
- Inspect the real
SKILL.mdbefore quoting, judging, or installing; identify candidates by path and gate every write. - Stop when one fit is clear, two High candidates need a winner, three angles add nothing, or user/auth approval is pending.
- Ship a standalone folder with one owner per concept; prune dead or duplicated material before done. Assume no sibling skill is installed: name a sibling to load, never depend on its files.
Smart routes — load only what the current step needs
- When discovering, load
references/search-playbook.md; choose a source withreferences/discovery-surfaces.md, parse manifests withreferences/discovery-manifests.md, and recover withreferences/recovery.md— search broadly enough without inventing candidates. - When judging, load
references/quality-rubric.mdfor content fit andreferences/quality-signals.mdfor adoption/recency; when recommending, present throughreferences/output-format.md— rank evidence, not popularity alone. - When designing structure, load
references/skill-anatomy.md; write withreferences/skill-authoring.md, extract deterministic work withreferences/skill-scripts.md, and tune activation withreferences/description-tuning.md— keep the lobby lean and triggers strong. - When improving, load
references/skill-improve.md; choose review/refactor mode withreferences/self-improvement.md, clean withreferences/skill-cleanup.md, and usereferences/improve-loop.mdonly ifoctocode-graph-evalis unavailable — preserve intent and require measurable acceptance. - Before done, load
references/skill-review.md; interpret findings withreferences/skill-review-rules.md— enforce structure, navigation (lobby shows every chunk, routes state when/why, chunks declare entry and next hop, flow phases routed), prose, and standalone-folder gates. - When reviewing lifecycle automation, load
references/hooks.md; when adding it, loadreferences/hooks-add.mdand useassets/hooks/— map the correct host event and avoid silent no-ops. - When installing, load
references/install-gates.md, thenreferences/install-destinations.md; remote sources usereferences/fetch-remote.md, local creation usesreferences/create-local-skill.md, and vendor links usereferences/skill-sync.md— secure approval, destination, and provenance before writes. - When evidence needs code/package/repository research, load
references/octocode.md— delegate research mechanics instead of duplicating them. - When tracing source provenance, load
references/references.md; when authoring a source appendix, start fromreferences/references-template.md— keep claims auditable without bloating instructions.
Show full SKILL.md (128 more words)Show less
Related routes
- Use
octocode-researchto verify candidates;octocode-prompt-optimizerto improve wording;octocode-graph-evalto measure behavior. - Use
octocode-rfc-generatorbefore a large skill-system redesign.
Scripts and done gate
- Run
scripts/skill-review.mjsafter any create/edit — zero ERROR is required. - Run
scripts/skill-sync.mjsonly after a dry-run and human approval — synchronize one source safely. scripts/skill-lint.mjsis an alias forscripts/skill-review.mjs— same gate under the older name.- A skill script needing Octocode home or env imports
./octocode-config.mjs, a build artifact injected bypackages/octocode-configinto every skill that imports it relatively — never import@octocodeai/configfrom a skill, or the folder breaks once installed alone. - When wiring a hook, copy
assets/hooks/example-hook.shintoscripts/hooks/and route it from frontmatter.
Installation
When creating or installing, follow the routed approval and destination gates, then run the review before reporting done.
© bgauryy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 37 other files (scripts, references, assets) in skills/octocode-skills of bgauryy/octocode.
- SKILL.md
- README.md
- assets/hooks/example-hook-brain.mjs
- assets/hooks/example-hook.sh
- references/create-local-skill.md
- references/description-tuning.md
- references/discovery-manifests.md
- references/discovery-surfaces.md
- references/fetch-remote.md
- references/hooks-add.md
- references/hooks.md
- references/improve-loop.md
- references/install-destinations.md
- references/install-gates.md
- references/octocode.md
- references/output-format.md
- references/quality-rubric.md
- references/quality-signals.md
- … and 20 more
Open the folder on GitHubat commit c265e3f
Compare with similar skills
Octocode Skills Manager 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 |
|---|---|---|---|---|---|---|
| Octocode Skills Manager this skillbgauryy/octocode | 949 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Darwin Skill Optimizeralchaincyf/darwin-skill | 6.2k | 1 repos | ~4.7k | Automated safety check: Pass | MIT | |
| Skill Creatorzhayujie/CowAgent | 47k | — | ~4.7k | Automated safety check: Notes | MIT | |
| Auto Skill Buildertradecatlabs/vibe-coding-cn | 17k | 1 repos | ~2.4k | Automated safety check: Pass | MIT | |
| Skill Seekers Builderyusufkaraaslan/Skill_Seekers | 15k | — | ~760 | Automated safety check: Pass | MIT | |
| Open-Science Skill Creatoraipoch/open-science | 5.5k | — | ~1.7k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Skill Creator
zhayujie/CowAgent
Guides creating, installing and updating agent skills in a workspace: SKILL.md frontmatter, bundled scripts and references, with scripts to scaffold, validate and package.
Auto Skill Builder
tradecatlabs/vibe-coding-cn
Meta-skill that turns docs, APIs, code or specs into a reusable skill with references and a quality gate, and refactors skills that are unclear or misfire.
Skill Seekers Builder
yusufkaraaslan/Skill_Seekers
Detects the type of a knowledge source and uses the Skill Seekers MCP tools to turn docs, repos, PDFs or videos into packaged AI skills.
Open-Science Skill Creator
aipoch/open-science
Creates, revises, evaluates and publishes skills in the Open-Science app through its native host.skills composer, with optional test prompts and benchmarks.
Skill Quality Reviewer
Galaxy-Dawn/claude-scholar
Scores a skill across description, content organization, writing style and structure, then produces letter grades and a prioritized improvement plan.
More from bgauryy/octocode
All 12 skills in this repoOctocode Benchmark Runner
bgauryy/octocode
Runs blind pairwise comparisons of Octocode against a gh-based baseline over markdown research questions, scored by total characters through the model rather than self-report.
Octocode Code Research
bgauryy/octocode
Researches code with evidence: traces callers, imports and cross-repo links, diagnoses failures and reports findings with exact file and line references and a confidence label.
Evidence-Backed Documentation Writer
bgauryy/octocode
Writes, repairs and copyedits project docs against the Google developer documentation style guide, verifying claims in the repository before stating them.
Octocode Mannequin
bgauryy/octocode
Poses and animates a 22-bone anatomical humanoid rig with joint range-of-motion limits, using a Node CLI, a Three.js viewer and WebMCP tools an agent can drive live.
Octocode Brainstorming
bgauryy/octocode
Walks an idea through framing, diverging into options, researching evidence and stress-testing before converging on a build, prototype, narrow or park decision.
Octocode Chrome Devtools
bgauryy/octocode
A skill your agent uses when a live page needs Chrome DevTools/CDP evidence: network failures, console errors, performance, DOM/CSS actionability, screenshots/PDF, cookies/storage…
Related
Works with
Categories
Questions about Octocode Skills Manager
What does Octocode Skills Manager do?
Finds, rates, reviews, creates, improves, installs and syncs Agent Skill folders from local workspaces, registries or remote sources, with a user gate before any write. md with optional references, scripts and assets. It follows a fixed flow from understanding the request through discovery, inspection, judging and a recommendation to a user gate, and only then acts, cleans up, reviews and verifies.
When should I use Octocode Skills Manager?
Octocode Skills Manager fits situations like: finding and comparing skills for a task from a registry or GitHub; reviewing or rating a SKILL.md for quality before installing it; creating or improving a local skill folder and tuning its description; installing or syncing skills with approval at each write.
How do I install Octocode Skills Manager in Claude Code?
Run `npx skills add bgauryy/octocode --skill octocode-skills -a claude-code`. Or copy the skill folder (skills/octocode-skills in bgauryy/octocode) into .claude/skills/octocode-skills in your project. Claude Code loads it when a task matches its description.
How do I install Octocode Skills Manager in Codex?
Run `npx skills add bgauryy/octocode --skill octocode-skills -a codex`. Or copy the skill folder (skills/octocode-skills in bgauryy/octocode) into .agents/skills/octocode-skills in your project. Codex loads it when a task matches its description.
Can I use Octocode Skills Manager in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bgauryy/octocode --skill octocode-skills -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/octocode-skills, .gemini/skills/octocode-skills, .github/skills/octocode-skills and .opencode/skills/octocode-skills in your project.
What does Octocode Skills Manager need to run?
Going by SKILL.md and its folder, Octocode Skills Manager needs JavaScript and a shell for the scripts in its folder.
Does Octocode Skills Manager access the network?
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.
Is Octocode Skills Manager safe to install?
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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Octocode Skills Manager use?
Octocode Skills Manager is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Octocode Skills Manager use?
About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 11k tokens, read only when the agent opens those files.
What are the alternatives to Octocode Skills Manager?
Skills that share tags, products or a category with Octocode Skills Manager: Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars), Skill Creator (zhayujie/CowAgent, 47k stars), Auto Skill Builder (tradecatlabs/vibe-coding-cn, 17k stars) and Skill Seekers Builder (yusufkaraaslan/Skill_Seekers, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Octocode Skills Manager?
bgauryy (a GitHub user) maintains it in bgauryy/octocode, which has 949 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 2026.
Source: bgauryy/octocode on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.