Agent skill

Skill Optimizer Lawvable

by lawve-ai in lawve-ai/awesome-legal-skills

Guide to analyze a current work session and propose improvements to skills.

AGPL-3.0Auto-check passedAgent Workflows

Install Skill Optimizer Lawvable

skills CLI
$ npx skills add lawve-ai/awesome-legal-skills --skill skill-optimizer-lawvable -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lawve-ai/awesome-legal-skills skill-optimizer-lawvable --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ 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-src

Use ~/.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/

Facts

Skill name
skill-optimizer-lawvable
GitHub stars
847
Token cost
~1.8k tokens
SKILL.md length
719 words
Files
4 (incl. scripts)
Skills in repo
154
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Guide to analyze a current work session and propose improvements to skills.

  • Works in 8 steps: Identify the Skill → Detect Signals → Evaluate Each Signal for Quality → …
  • Suggests improvements
  • SKILL.md covers Triggers, Main Workflow (self-improve), Secondary Commands and self-improve [skill-name]…, plus 2 more sections
  • Runs Shell scripts from its folder

What it does

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.

When your agent uses it

  • Suggests improvements
  • Additions during a skill-related session
  • The user manually invokes self-improve

Example prompts

  • “/skill-optimizer-lawvable”

Requirements

  • A Bash shell

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Identify the Skill
  2. Detect Signals
  3. Evaluate Each Signal for Quality
  4. Grade the Signal
  5. Ask for Clarification
  6. Propose Changes
  7. If Approved
  8. Save Observations

What it can do on your machine

Read from SKILL.md and the folder at commit 045f738. 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/ (Shell), 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

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.

Always · name and description, kept in context so the agent knows when to use it
~81
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

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 lawve-ai/awesome-legal-skills at commit 045f738, republished under its AGPL-3.0 licence (© lawve-ai). 719 words, ~1,819 tokens.

Download SKILL.mdSave it as .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.
name
skill-optimizer-lawvable
description
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`.
metadata.author
Malik Taiar (Lawvable)
metadata.license
AGPL-3.0
metadata.version
2026.01.07

Self-Improve Skill

Analyze the current conversation and propose improvements to skills based on corrections, successes, and edge cases discovered during the work session.

Triggers

  • self-improve - Analyze session and propose improvements
  • self-improve [skill-name] - Target a specific skill
  • self-improve on - Enable automatic mode (hook)
  • self-improve off - Disable automatic mode
  • self-improve status - Show automatic mode status
  • self-improve [skill-name] history - Show modification history

Main Workflow (self-improve)

Step 1: Identify the Skill

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]
Step 2: Detect Signals

Scan the conversation for signals - moments where the user expressed feedback:

Signal TypeExamples
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 caseUser needed a workaround, skill couldn't handle the request
Step 3: Evaluate Each Signal for Quality

For each correction signal, evaluate if it can become a good skill instruction.

Quality Criteria

1. COMPLETE

The instruction includes all information needed to apply it. No need to look elsewhere or make assumptions.

GradeExample
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.

GradeExample
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.

GradeExample
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.

GradeExample
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)
Step 4: Grade the Signal
Criteria MetAction
All 4 criteria passAdd to skill directly
Less than 4 criteriaAsk for clarification (see Step 5)
Step 5: Ask for Clarification

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.

Step 6: Propose Changes
--- 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]
Show full SKILL.md (308 more words)Show less
Step 7: If Approved
  1. Update SKILL.md

    • Read skills/[skill-name]/SKILL.md
    • Add each instruction in the appropriate section
    • Each instruction must be readable and applicable on its own
  2. Update skills/[skill-name]/CHANGELOG.md

    • Create if doesn't exist
    • Add new entry AT THE TOP:
      markdown
      ## [DATE (format: "January 7, 2026")]
      [Description of changes in natural language, 1-3 sentences]
    • Entry rules:
      • Most recent at top
      • 1-3 sentences max
      • Natural language
      • No git references
Step 8: Save Observations

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


Secondary Commands

self-improve on
  1. Run:
    bash
    rm -f ./.disabled
  2. Reply: "Automatic mode enabled."
self-improve off
  1. Run:
    bash
    touch ./.disabled
  2. Reply: "Automatic mode disabled."
self-improve status

Check .disabled file existence and report.

self-improve [skill-name] history

  1. Display CHANGELOG.md content
  2. Ask: "Would you like to revert to a previous version?"
  3. If yes:
    • update the appropriate sections in skills/[skill-name]/SKILL.md
    • update skills/[skill-name]/CHANGELOG.md with a rollback note

Examples

Example 1: All criteria met

User said: "Always flag non-compete clauses over 12 months as high risk"

Evaluation:

  • Complete: Yes - instruction is fully specified
  • Precise: Yes - "12 months" and "high risk" are clear
  • Atomic: Yes - single check
  • Stable: Yes - no time dependency

Result: Add directly

Example 2: Missing criteria

User said: "Flag any non-market-standard indemnification clause"

Evaluation:

  • Complete: No - "non-market-standard" is not defined
  • Precise: No - "market standard" is subjective and varies by deal type
  • Atomic: Yes - single check
  • Stable: No - market standards evolve over time

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.


Important Notes

  • Never guess what the user meant - always ask if unclear
  • Never infer requirements from context - they must be explicit
  • One instruction = one check - split bundled feedback
  • Fewer good instructions is better than many vague ones
  • CHANGELOG.md is the user-facing record

© 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

Files

SKILL.md and 3 other files (scripts) in skills/skill-improvement-malik-taiar of lawve-ai/awesome-legal-skills.

  • SKILL.md
  • LICENSE.txt
  • README.md
  • scripts/self-improve-hook.sh

Open the folder on GitHubat commit 045f738

Compare with similar skills

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 Optimizer Lawvable compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Optimizer Lawvable this skilllawve-ai/awesome-legal-skills847—~1.8kAutomated safety check: PassAGPL-3.0
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Using Agent Skillsaddyosmani/agent-skills105k4 repos~2.4kAutomated safety check: PassMIT
Ponytail Help CardDietrichGebert/ponytail160k—~726Automated safety check: PassMIT
Skill Creatorzhayujie/CowAgent47k—~4.7kAutomated safety check: NotesMIT
Task Observerrebelytics/one-skill-to-rule-them-all3.2k1 repos~11kAutomated safety check: PassCC-BY-4.0

Similar skills

  • 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.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Using Agent Skills

    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.

    105k GitHub starsUsed in 4 repos~2.4k tokens
    Agent WorkflowsAuto-check passed
  • Ponytail Help Card

    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.

    160k GitHub stars~726 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • 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.

    47k GitHub stars~4.7k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Task Observer

    rebelytics/one-skill-to-rule-them-all

    Monitors task execution for skill improvement opportunities.

    3.2k GitHub starsUsed in 1 repo~11k tokens
    Agent WorkflowsAuto-check passed
  • 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.

    5.5k GitHub stars~1.7k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from lawve-ai/awesome-legal-skills

All 154 skills in this repo
  • Customs Trade Law Onur Kafkas

    lawve-ai/awesome-legal-skills

    U.S. An agent skill from lawve-ai/awesome-legal-skills.

    847 GitHub stars~4.1k tokensUpdated 8 days ago
    Auto-check passed
  • Eu Data Act Oliver Schmidt Prietz

    lawve-ai/awesome-legal-skills

    Practitioner skill for advising on EU Regulation 2023/2854 (Data Act).

    847 GitHub stars~3.9k tokensUpdated 8 days ago
    Auto-check passed
  • Litigation Deadline Calendar

    lawve-ai/awesome-legal-skills

    Calendar litigation and arbitration deadlines from a scheduling order.

    847 GitHub stars~4.3k tokensUpdated 8 days ago
    Auto-check passed
  • Outlook Emails Lawvable

    lawve-ai/awesome-legal-skills

    Read, search, and download emails and attachments from Microsoft Outlook via OAuth2.

    847 GitHub stars~672 tokensUpdated 8 days ago
    Auto-check passed
  • Ambiguity Report

    lawve-ai/awesome-legal-skills

    Turn an interpretive-ambiguity audit of a legal text — contract, statute, regulation, or judicial opinion — into a polished deliverable.

    847 GitHub stars~4.6k tokensUpdated 8 days ago
    Auto-check passed
  • Az Eu Website Privacy Audit

    lawve-ai/awesome-legal-skills

    Audits a website for compliance with Azerbaijan's Law on Personal Data No.

    847 GitHub stars~3.8k tokensUpdated 8 days ago
    Auto-check passed

Categories

Questions about Skill Optimizer Lawvable

What does Skill Optimizer Lawvable do?

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.

When should I use Skill Optimizer Lawvable?

Skill Optimizer Lawvable fits situations like: suggests improvements; additions during a skill-related session; the user manually invokes self-improve.

How do I install Skill Optimizer Lawvable in Claude Code?

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.

How do I install Skill Optimizer Lawvable in Codex?

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.

Can I use Skill Optimizer Lawvable 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 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.

What does Skill Optimizer Lawvable need to run?

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.

Does Skill Optimizer Lawvable 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 Skill Optimizer Lawvable 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 Skill Optimizer Lawvable use?

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.

How many tokens does Skill Optimizer Lawvable use?

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.

What are the alternatives to Skill Optimizer Lawvable?

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.

Who maintains Skill Optimizer Lawvable?

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.