New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Self Improve

by forefy in forefy/.context

Audit the conversation and the project for what could have gone better, then turn the generalizable lessons into committed improvements in the repo that hosts this skill.

MITAuto-check passedSecurity

Install Self Improve

skills CLI
$ npx skills add forefy/.context --skill self-improve -a claude-code

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

GitHub CLI
$ gh skill install forefy/.context self-improve --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/forefy/.context.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/generic-utils/self-improve .claude/skills/self-improve && 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
self-improve
GitHub stars
152
Token cost
~1k tokens
SKILL.md length
605 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

Audit the conversation and the project for what could have gone better, then turn the generalizable lessons into committed improvements in the repo that hosts this skill.

  • Works in 4 steps: Review the conversation for corrections,… → Separate the one-off from the… → Find the right home for each lesson. A… → …
  • Security work in your project
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Self Improve is an agent skill from forefy/.context. Audit the conversation and the project for what could have gone better, then turn the generalizable lessons into committed improvements in the repo that hosts this skill. Use at the end of a task or conversation where the agent needed correction, repeated work, or took a longer path than necessary.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: skill file must be hosted on a git repository the agent can push to

It sits in Security. The repository describes itself as: AI Agent Skills, Goals and Dynamic Workflows for Security Auditing, Pentesting and Research. The licence is MIT.

When your agent uses it

  • Security work in your project

Example prompts

  • “/self-improve”

Requirements

  • Compatibility (from SKILL.md): skill file must be hosted on a git repository the agent can push to

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Review the conversation for corrections, retries, and dead ends. Each one is a candidate.
  2. Separate the one-off from the generalizable. Only the generalizable is worth writing down.
  3. Find the right home for each lesson. A rule about this repo belongs in the repo. A rule about how the agent works belongs in a skill. A…
  4. Make the change, then verify it against the checks below before committing.

What it can do on your machine

Read from SKILL.md and the folder at commit c8ff161. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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.

  • Compatibility

    skill file must be hosted on a git repository the agent can push to

    From compatibility in the SKILL.md frontmatter.

Context cost

Self Improve loads about 1k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 605 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from forefy/.context at commit c8ff161, republished under its MIT licence (© forefy). 605 words, ~1,048 tokens.

Download SKILL.mdSave it as .claude/skills/self-improve/SKILL.md (or your agent's skills folder).
name
self-improve
description
Audit the conversation and the project for what could have gone better, then turn the generalizable lessons into committed improvements in the repo that hosts this skill. Use at the end of a task or conversation where the agent needed correction, repeated work, or took a longer path than necessary.
compatibility
skill file must be hosted on a git repository the agent can push to

Purpose

Every run that invokes this skill should leave the next run better off than the last, by pushing what was learned back through the git source this skill is hosted at.

A lesson that stays in the conversation dies with the context window. A lesson written into a skill, a memory file, or a doc is the only kind that survives.

Task definition

Audit the conversation and the project to find opportunities to improve how work is done here. Reflect on what was actually done, where it went wrong, and where it could have been done better.

What counts as an improvement:

  • Continuation. A fresh context loading this repo to do the same task hits the same pitfalls unless something in the repo changes. Removing that repeat cost is the highest-value improvement available.
  • Correct work rather than a workaround that grows more painful as the project does.
  • Updates to project memory, skills and docs that generalize past the single case that prompted them.

What does not count:

  • Changes that do not align with the project's long-term direction.
  • Overbuilding something that does not merit it on a second look.
  • Anything that trades away UX, security or reliability.

Method

  1. Review the conversation for corrections, retries, and dead ends. Each one is a candidate.
  2. Separate the one-off from the generalizable. Only the generalizable is worth writing down.
  3. Find the right home for each lesson. A rule about this repo belongs in the repo. A rule about how the agent works belongs in a skill. A fact that is not derivable from the code belongs in project memory.
  4. Make the change, then verify it against the checks below before committing.
Show full SKILL.md (324 more words)Show less

Pre-commit checks

  • Run the tests, and add tests covering new critical functionality.
  • Security review the changed code and confirm no critical issue was introduced.
  • Remove leftovers before committing: dead code, scratch scripts, sensitive data, and anything that pollutes history. History is effectively permanent, so this is both a professionalism and a security matter.
  • Write short, accurate, human commit messages.
  • Push to the working branch only with approval and at high confidence that nothing breaks.
  • Planning notes, changelogs and scratch markdown files are often not useful to other developers. Ask the user before committing them, and delete them when they are not wanted.
  • Before committing, check as far as possible that the change works and broke nothing.
  • Commit no personal files, PII or names without explicit approval. Code must stay portable, with no hardcoded user paths or emails. Personal values belong in environment secrets if they belong anywhere.
  • Replace em dashes with regular hyphens across the codebase, with one exception: database migration files such as migrations/*.sql are immutable once applied, and editing them changes their checksum and breaks deploys.
  • Confirm any changed frontend component is screen-adaptive.
  • Check that a fix made for the local environment also holds where it is deployed. A missing dependency resolved locally needs the deployment path to handle it too.
  • Update the project's documentation where it is managed, whether that is in-repo docs or an external system.

Git protocol

Work on the branch of the current context, including main, and push improvements back to that same branch. Use a pull request flow only when the user asked for a separate branch.

Raise improvements at the end of a task or conversation whenever there is something worth carrying forward. Land them with the user's approval rather than silently, so the user stays in control of what enters the repo.

Result

Improvements are committed where the next run will actually load them, and the same correction does not have to be made twice.

© forefy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/generic-utils/self-improve of forefy/.context.

Open the folder on GitHubat commit c8ff161

Compare with similar skills

Self Improve 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.

Self Improve compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Self Improve this skillforefy/.context152—~1kAutomated safety check: PassMIT
Fla Ascend Performancefla-org/flash-linear-attention5.8k—~5.6kAutomated safety check: PassMIT
Deepsec Documentation Guidevercel-labs/deepsec8.1k—~956Automated safety check: PassApache-2.0
Skill Scannergetsentry/skills1k4 repos~2.5kAutomated safety check: WarnApache-2.0
Serenity Aleabitoreddityan-labs/serenity-aleabitoreddit4791 repos~3.3kAutomated safety check: PassNone
Security Alert Triageelastic/agent-skills5921 repos~3.5kAutomated safety check: NotesApache-2.0

Similar skills

  • Fla Ascend Performance

    fla-org/flash-linear-attention

    Guidelines for Ascend NPU kernel / Triton-Ascend backend performance work in the FLA repo.

    5.8k GitHub stars~5.6k tokensUpdated yesterday
    SecurityAuto-check passed

  • Deepsec Documentation Guide

    vercel-labs/deepsec

    Official

    Points the agent at deepsec's own docs to answer questions about initializing, configuring, resuming, scanning with and extending the vulnerability scanner.

    8.1k GitHub stars~956 tokensUpdated 8 days ago
    SecurityAuto-check passed

  • Skill Scanner

    getsentry/skills

    Official

    Scan agent skills for security issues. An agent skill from getsentry/skills.

    1k GitHub starsUsed in 4 repos~2.5k tokens
    SecurityAuto-check: warnings

  • Serenity Aleabitoreddit

    yan-labs/serenity-aleabitoreddit

    Apply trader Serenity's (@aleabitoreddit) AI/semiconductor supply-chain analytical lens to US-stock ideas and market judgment.

    479 GitHub starsUsed in 1 repo~3.3k tokens
    SecurityAuto-check passed

  • Security Alert Triage

    elastic/agent-skills

    Official

    Triage Elastic Security alerts — gather context, classify threats, create cases, and acknowledge.

    592 GitHub starsUsed in 1 repo~3.5k tokens
    SecurityAuto-check: notes

  • Shiro Attack CLI

    SummerSec/ShiroAttack2

    当用户要求利用、检测或测试 Apache Shiro rememberMe 反序列化漏洞 (Shiro-550, CVE-2016-4437) 时使用。触发词包括 "Shiro"、"rememberMe"、"shiro attack"、"CVE-2016-4437"、"Shiro-550"、"爆破 Shiro key"、"利用 Shiro"、"Shiro…

    2.6k GitHub stars~945 tokensUpdated 4 mo ago
    SecurityAuto-check passed

More from forefy/.context

All 20 skills in this repo

  • Google Docs Audit Reports

    forefy/.context

    Builds and formats security audit reports in Google Docs through the Docs API, with fixes for index drift, code styling and cross-reference links.

    152 GitHub stars~951 tokensUpdated 2 days ago
    Auto-check passed

  • Safe Multisig Governance Audit

    forefy/.context

    Audits the Safe multisig wallets of DeFi protocols for governance misconfigurations, scoring each against a finding library and producing a severity-ranked report.

    152 GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed

  • Cloud Bucket Exposure Finder

    forefy/.context

    Turns a company's domains into likely storage bucket names and checks six cloud providers for publicly readable buckets, for authorized security assessments only.

    152 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed

  • Audit Scope

    forefy/.context

    Draft a security-audit scope from GitHub repos or API access, with a protocol narrative and a sizing table.

    152 GitHub stars~2.3k tokensUpdated 2 days ago
    Auto-check passed

  • External Enumeration

    forefy/.context

    Passively map a company's domains, subdomains, DNS ownership, tech stack, and CDNs.

    152 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed

  • Smart Contract Audit

    forefy/.context

    Comprehensive smart contract security audit framework with multi-expert analysis.

    152 GitHub starsUsed in 1 repo~5.1k tokens
    Auto-check passed

Categories

Questions about Self Improve

What does Self Improve do?

Audit the conversation and the project for what could have gone better, then turn the generalizable lessons into committed improvements in the repo that hosts this skill. context. Audit the conversation and the project for what could have gone better, then turn the generalizable lessons into committed improvements in the repo that hosts this skill.

When should I use Self Improve?

Self Improve fits situations like: security work in your project.

How do I install Self Improve in Claude Code?

Run `npx skills add forefy/.context --skill self-improve -a claude-code`. Or copy the skill folder (skills/generic-utils/self-improve in forefy/.context) into .claude/skills/self-improve in your project. Claude Code loads it when a task matches its description.

How do I install Self Improve in Codex?

Run `npx skills add forefy/.context --skill self-improve -a codex`. Or copy the skill folder (skills/generic-utils/self-improve in forefy/.context) into .agents/skills/self-improve in your project. Codex loads it when a task matches its description.

Can I use Self Improve 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 forefy/.context --skill self-improve -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/self-improve, .gemini/skills/self-improve, .github/skills/self-improve and .opencode/skills/self-improve in your project.

What does Self Improve need to run?

SKILL.md names no scripts, command-line tools or credentials: Self Improve is instructions for the agent only. Compatibility (from SKILL.md): skill file must be hosted on a git repository the agent can push to.

Does Self Improve 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 Self Improve 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. Review the folder before installing.

What licence does Self Improve use?

Self Improve 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 Self Improve use?

About 1k tokens (SKILL.md is roughly 4.2k 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 Self Improve?

Skills that share tags, products or a category with Self Improve: Fla Ascend Performance (fla-org/flash-linear-attention, 5.8k stars), Deepsec Documentation Guide (vercel-labs/deepsec, 8.1k stars), Skill Scanner (getsentry/skills, 1k stars) and Serenity Aleabitoreddit (yan-labs/serenity-aleabitoreddit, 479 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Self Improve?

forefy (a GitHub user) maintains it in forefy/.context, which has 152 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 4, 2026.

Source: forefy/.context on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.