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.
Guide to analyze a current work session and propose improvements to skills.
$ npx skills add lawve-ai/awesome-legal-skills --skill skill-optimizer-lawvable -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install lawve-ai/awesome-legal-skills skill-optimizer-lawvable --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/lawve-ai/awesome-legal-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skill-improvement-malik-taiar .claude/skills/skill-optimizer-lawvable && 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 "skill-optimizer-lawvable" agent skill from https://github.com/lawve-ai/awesome-legal-skills/tree/main/skills/skill-improvement-malik-taiar into .claude/skills/skill-optimizer-lawvable/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-optimizer-lawvable", 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/lawve-ai/awesome-legal-skills/tree/main/skills/skill-improvement-malik-taiarType 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 lawve-ai/awesome-legal-skills --skill skill-optimizer-lawvable -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install lawve-ai/awesome-legal-skills skill-optimizer-lawvable --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/lawve-ai/awesome-legal-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/skill-improvement-malik-taiar .agents/skills/skill-optimizer-lawvable && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "skill-optimizer-lawvable" agent skill from https://github.com/lawve-ai/awesome-legal-skills/tree/main/skills/skill-improvement-malik-taiar into .agents/skills/skill-optimizer-lawvable/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-optimizer-lawvable", 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 lawve-ai/awesome-legal-skills --skill skill-optimizer-lawvable -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install lawve-ai/awesome-legal-skills skill-optimizer-lawvable --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/lawve-ai/awesome-legal-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/skill-improvement-malik-taiar .cursor/skills/skill-optimizer-lawvable && 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 "skill-optimizer-lawvable" agent skill from https://github.com/lawve-ai/awesome-legal-skills/tree/main/skills/skill-improvement-malik-taiar into .cursor/skills/skill-optimizer-lawvable/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-optimizer-lawvable", 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/lawve-ai/awesome-legal-skills.git --path skills/skill-improvement-malik-taiar--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 lawve-ai/awesome-legal-skills --skill skill-optimizer-lawvable -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install lawve-ai/awesome-legal-skills skill-optimizer-lawvable --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/lawve-ai/awesome-legal-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/skill-improvement-malik-taiar .gemini/skills/skill-optimizer-lawvable && 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 "skill-optimizer-lawvable" agent skill from https://github.com/lawve-ai/awesome-legal-skills/tree/main/skills/skill-improvement-malik-taiar into .gemini/skills/skill-optimizer-lawvable/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-optimizer-lawvable", 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 lawve-ai/awesome-legal-skills skill-optimizer-lawvableInstalls 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 lawve-ai/awesome-legal-skills --skill skill-optimizer-lawvable -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/lawve-ai/awesome-legal-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/skill-improvement-malik-taiar .github/skills/skill-optimizer-lawvable && 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 "skill-optimizer-lawvable" agent skill from https://github.com/lawve-ai/awesome-legal-skills/tree/main/skills/skill-improvement-malik-taiar into .github/skills/skill-optimizer-lawvable/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-optimizer-lawvable", 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 lawve-ai/awesome-legal-skills --skill skill-optimizer-lawvable -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install lawve-ai/awesome-legal-skills skill-optimizer-lawvable --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/lawve-ai/awesome-legal-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/skill-improvement-malik-taiar .opencode/skills/skill-optimizer-lawvable && 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 "skill-optimizer-lawvable" agent skill from https://github.com/lawve-ai/awesome-legal-skills/tree/main/skills/skill-improvement-malik-taiar into .opencode/skills/skill-optimizer-lawvable/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-optimizer-lawvable", 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.
skill-optimizer-lawvableGuide to analyze a current work session and propose improvements to skills.
Skill Optimizer Lawvable is an agent skill from lawve-ai/awesome-legal-skills. Guide to analyze a current work session and propose improvements to skills. Use (1) automatically after working with a skill to capture learnings, (2) when the user suggests improvements, corrections, or additions during a skill-related session, or (3) when the user manually invokes self-improve.
Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `README.md` and `scripts/self-improve-hook.sh`).
It sits in Agent Workflows, covering Skill management. The repository describes itself as: A curated list of awesome Agent Skills for automating legal work. The licence is AGPL-3.0.
8 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 045f738. 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.
Ships 1 file in scripts/ (Shell), which the agent can run.
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 no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Skill Optimizer Lawvable loads about 1.8k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 719 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); the scripts in this folder are not scanned.
The full file from lawve-ai/awesome-legal-skills at commit 045f738, republished under its AGPL-3.0 licence (© lawve-ai). 719 words, ~1,819 tokens.
.claude/skills/skill-optimizer-lawvable/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.Analyze the current conversation and propose improvements to skills based on corrections, successes, and edge cases discovered during the work session.
self-improve - Analyze session and propose improvementsself-improve [skill-name] - Target a specific skillself-improve on - Enable automatic mode (hook)self-improve off - Disable automatic modeself-improve status - Show automatic mode statusself-improve [skill-name] history - Show modification historyself-improve)If skill name not provided, list available skills from skills/ directory and ask:
Which skill should I analyze for this session?
[List skills found in skills/ directory]Scan the conversation for signals - moments where the user expressed feedback:
| Signal Type | Examples |
|---|---|
| Correction | "No", "That's not right", "It's missing X", "Always do Y", user rewrites output |
| Success | "Perfect", "Yes", "Exactly", user accepts without changes |
| Edge case | User needed a workaround, skill couldn't handle the request |
For each correction signal, evaluate if it can become a good skill instruction.
1. COMPLETE
The instruction includes all information needed to apply it. No need to look elsewhere or make assumptions.
| Grade | Example |
|---|---|
| Pass | "Structure output as: Key Terms / Risk Areas / Suggested Revisions" |
| Fail | "Use the standard format" (which format?) |
| Fail | "Follow our firm's guidelines" (what guidelines?) |
2. PRECISE
No vague or subjective terms. Two different people reading the instruction would understand it the same way.
| Grade | Example |
|---|---|
| Pass | "Flag non-compete clauses over 12 months as high risk" |
| Fail | "Be more thorough in the analysis" |
| Fail | "Make it more appropriate for clients" |
3. ATOMIC
One instruction addresses one single requirement. Multiple checks should be split into separate instructions.
| Grade | Example |
|---|---|
| Pass | "Check for governing law clause" |
| Fail | "Check for governing law, jurisdiction, and arbitration clauses" (three checks - split them) |
4. STABLE
If referencing regulations or standards, specify the version or date. The instruction should be evaluable the same way regardless of when it's read.
| Grade | Example |
|---|---|
| Pass | "Review the termination provisions under our internal policy [policy name and reference], dated December 12, 2024." |
| Fail | "Follow latest market standards" (which standards? will change over time) |
| Criteria Met | Action |
|---|---|
| All 4 criteria pass | Add to skill directly |
| Less than 4 criteria | Ask for clarification (see Step 5) |
When feedback doesn't meet all criteria, ask for what's missing using the AskUserQuestion tool:
I detected a correction but need more information to improve the skill.
You said: "[user's feedback]"
To create a clearer instruction, I need the following information:
[Structured tool call listing what's missing based on failed criteria]If the user provides clarification → Update the instruction and proceed to Step 6.
If the user prefers the original → Proceed to Step 6 with the original instruction.
--- Learning: [skill-name] ---
Proposed additions:
1. "[exact instruction to add]"
Source: "[quote from conversation]"
2. "[exact instruction to add]"
Source: "[quote from conversation]"
---
Apply these changes? [Y/n]Update SKILL.md
skills/[skill-name]/SKILL.mdUpdate skills/[skill-name]/CHANGELOG.md
## [DATE (format: "January 7, 2026")]
[Description of changes in natural language, 1-3 sentences]For signals that couldn't be processed, offer to save:
Save these observations for later review?
- "[signal 1]" - Status: [why insufficient]
- "[signal 2]" - Status: [why insufficient]If yes, append to skills/[skill-name]/OBSERVATIONS.md
rm -f ./.disabledtouch ./.disabledCheck .disabled file existence and report.
skills/[skill-name]/SKILL.mdskills/[skill-name]/CHANGELOG.md with a rollback noteUser said: "Always flag non-compete clauses over 12 months as high risk"
Evaluation:
Result: Add directly
User said: "Flag any non-market-standard indemnification clause"
Evaluation:
Action: Ask for clarification using the AskUserQuestion tool:
I detected a correction but need more details.
You said: "Flag any non-market-standard indemnification clause"
To make this actionable, can you specify:
- What makes an indemnification clause "non-market-standard"? (e.g., uncapped liability, coverage of indirect damages, no carve-outs for gross negligence)
Do you want to provide more details, or should I add the instruction as you stated it?If user clarifies: Update the instruction and add it. If user prefers the original: Add the instruction as stated.
© lawve-ai, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 3 other files (scripts) in skills/skill-improvement-malik-taiar of lawve-ai/awesome-legal-skills.
Open the folder on GitHubat commit 045f738
Skill Optimizer Lawvable 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 |
|---|---|---|---|---|---|---|
| Skill Optimizer Lawvable this skilllawve-ai/awesome-legal-skills | 847 | — | ~1.8k | Automated safety check: Pass | AGPL-3.0 | |
| Darwin Skill Optimizeralchaincyf/darwin-skill | 6.2k | 1 repos | ~4.7k | Automated safety check: Pass | MIT | |
| Using Agent Skillsaddyosmani/agent-skills | 105k | 4 repos | ~2.4k | Automated safety check: Pass | MIT | |
| Ponytail Help CardDietrichGebert/ponytail | 160k | — | ~726 | Automated safety check: Pass | MIT | |
| Skill Creatorzhayujie/CowAgent | 47k | — | ~4.7k | Automated safety check: Notes | MIT | |
| Task Observerrebelytics/one-skill-to-rule-them-all | 3.2k | 1 repos | ~11k | Automated safety check: Pass | CC-BY-4.0 |
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.
addyosmani/agent-skills
Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.
DietrichGebert/ponytail
Shows a one-shot quick-reference card for the ponytail skills: intensity levels, the six commands, and how to turn it off, set a default mode and update.
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.
rebelytics/one-skill-to-rule-them-all
Monitors task execution for skill improvement opportunities.
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.
lawve-ai/awesome-legal-skills
U.S. An agent skill from lawve-ai/awesome-legal-skills.
lawve-ai/awesome-legal-skills
Practitioner skill for advising on EU Regulation 2023/2854 (Data Act).
lawve-ai/awesome-legal-skills
Calendar litigation and arbitration deadlines from a scheduling order.
lawve-ai/awesome-legal-skills
Read, search, and download emails and attachments from Microsoft Outlook via OAuth2.
lawve-ai/awesome-legal-skills
Turn an interpretive-ambiguity audit of a legal text — contract, statute, regulation, or judicial opinion — into a polished deliverable.
lawve-ai/awesome-legal-skills
Audits a website for compliance with Azerbaijan's Law on Personal Data No.
Categories
Guide to analyze a current work session and propose improvements to skills. Skill Optimizer Lawvable is an agent skill from lawve-ai/awesome-legal-skills. Guide to analyze a current work session and propose improvements to skills.
Skill Optimizer Lawvable fits situations like: suggests improvements; additions during a skill-related session; the user manually invokes self-improve.
Run `npx skills add lawve-ai/awesome-legal-skills --skill skill-optimizer-lawvable -a claude-code`. Or copy the skill folder (skills/skill-improvement-malik-taiar in lawve-ai/awesome-legal-skills) into .claude/skills/skill-optimizer-lawvable in your project. Claude Code loads it when a task matches its description.
Run `npx skills add lawve-ai/awesome-legal-skills --skill skill-optimizer-lawvable -a codex`. Or copy the skill folder (skills/skill-improvement-malik-taiar in lawve-ai/awesome-legal-skills) into .agents/skills/skill-optimizer-lawvable 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 lawve-ai/awesome-legal-skills --skill skill-optimizer-lawvable -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-optimizer-lawvable, .gemini/skills/skill-optimizer-lawvable, .github/skills/skill-optimizer-lawvable and .opencode/skills/skill-optimizer-lawvable in your project.
Going by SKILL.md and its folder, Skill Optimizer Lawvable needs a shell for the scripts in its folder. Our summary lists: A Bash shell.
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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Skill Optimizer Lawvable is published under the AGPL-3.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.8k tokens (SKILL.md is roughly 7.3k 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 Skill Optimizer Lawvable: Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars), Using Agent Skills (addyosmani/agent-skills, 105k stars), Ponytail Help Card (DietrichGebert/ponytail, 160k stars) and Skill Creator (zhayujie/CowAgent, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
lawve-ai (a GitHub organization) maintains it in lawve-ai/awesome-legal-skills, which has 847 GitHub stars. The repository holds 154 skills in this directory. The repository was last updated on October 2, 2026.
Source: lawve-ai/awesome-legal-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.