Feedback
codewhale-hq/Codewhale
Report a Codewhale bug or idea as a GitHub issue. An agent skill from codewhale-hq/Codewhale.
Self-improvement logging and closed-loop feedback: Trigger when a command or operation fails, the user corrects you, outdated knowledge is identified, an external API fails, or a better reusable…
$ npx skills add OpenMinis/MinisSkills --skill self-improving-agent -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install OpenMinis/MinisSkills self-improving-agent --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/OpenMinis/MinisSkills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/self-improving-agent .claude/skills/self-improving-agent && 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 "self-improving-agent" agent skill from https://github.com/OpenMinis/MinisSkills/tree/main/self-improving-agent into .claude/skills/self-improving-agent/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-improving-agent", 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/OpenMinis/MinisSkills/tree/main/self-improving-agentType 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 OpenMinis/MinisSkills --skill self-improving-agent -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install OpenMinis/MinisSkills self-improving-agent --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OpenMinis/MinisSkills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/self-improving-agent .agents/skills/self-improving-agent && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "self-improving-agent" agent skill from https://github.com/OpenMinis/MinisSkills/tree/main/self-improving-agent into .agents/skills/self-improving-agent/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-improving-agent", 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 OpenMinis/MinisSkills --skill self-improving-agent -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install OpenMinis/MinisSkills self-improving-agent --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OpenMinis/MinisSkills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/self-improving-agent .cursor/skills/self-improving-agent && 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 "self-improving-agent" agent skill from https://github.com/OpenMinis/MinisSkills/tree/main/self-improving-agent into .cursor/skills/self-improving-agent/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-improving-agent", 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/OpenMinis/MinisSkills.git --path self-improving-agent--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 OpenMinis/MinisSkills --skill self-improving-agent -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install OpenMinis/MinisSkills self-improving-agent --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OpenMinis/MinisSkills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/self-improving-agent .gemini/skills/self-improving-agent && 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 "self-improving-agent" agent skill from https://github.com/OpenMinis/MinisSkills/tree/main/self-improving-agent into .gemini/skills/self-improving-agent/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-improving-agent", 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 OpenMinis/MinisSkills self-improving-agentInstalls 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 OpenMinis/MinisSkills --skill self-improving-agent -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/OpenMinis/MinisSkills.git skills-src && mkdir -p .github/skills && cp -r skills-src/self-improving-agent .github/skills/self-improving-agent && 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 "self-improving-agent" agent skill from https://github.com/OpenMinis/MinisSkills/tree/main/self-improving-agent into .github/skills/self-improving-agent/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-improving-agent", 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 OpenMinis/MinisSkills --skill self-improving-agent -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install OpenMinis/MinisSkills self-improving-agent --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OpenMinis/MinisSkills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/self-improving-agent .opencode/skills/self-improving-agent && 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 "self-improving-agent" agent skill from https://github.com/OpenMinis/MinisSkills/tree/main/self-improving-agent into .opencode/skills/self-improving-agent/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-improving-agent", 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.
self-improving-agentSelf-improvement logging and closed-loop feedback: Trigger when a command or operation fails, the user corrects you, outdated knowledge is identified, an external API fails, or a better reusable…
Self Improving Agent is an agent skill from OpenMinis/MinisSkills. Self-improvement logging and closed-loop feedback: Trigger when a command or operation fails, the user corrects you, outdated knowledge is identified, an external API fails, or a better reusable solution is found. Review historical learnings before important tasks. Avoid triggering during ordinary chat, for temporary mistakes that do not need to be logged, or when the user has explicitly said not to log.
Its SKILL.md is about 3.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts (for example `data/ERRORS.md`, `data/FEATURE_REQUESTS.md` and `data/LEARNINGS.md`).
The repository describes itself as: Skills collection for Minis. The licence is MIT.
5 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit ae8c5db. 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.
Shell commands in SKILL.md call:
shFrom 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.
Self Improving Agent loads about 3.6k tokens when it runs. Until then it costs about 107 tokens; SKILL.md has 1,354 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 OpenMinis/MinisSkills at commit ae8c5db, republished under its MIT licence (© OpenMinis). 1,354 words, ~3,593 tokens.
.claude/skills/self-improving-agent/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.This skill is used in the Minis environment to record errors, corrections, and reusable best practices, creating a traceable learning loop.
/var/minis/workspace//var/minis/skills/self-improving-agent/data//var/minis/skills/self-improving-agent/data/public/<project>/.learnings/LEARNINGS.md (corrections, knowledge gaps, best practices)ERRORS.md (command failures, exception output)FEATURE_REQUESTS.md (new capabilities requested by users)By default, log entries go first to the skill's own
datadirectory. When you explicitly specify a project, write to the project-level log. When an issue has been abstracted into a cross-project rule, promote it to the skill's public area or the Minis memory system.
/var/minis/skills/self-improving-agent/data//var/minis/skills/self-improving-agent/data/public/<project>/.learnings/ only when --project <path> is passed explicitly--public--workspace is still available, but only for compatibility and is no longer recommendedpromote <entryID> copies the entry to the public area within the skill, automatically marks the source entry as promoted, and writes back **Promoted to** and ### Resolution Recordpromote again will not append a duplicate| Scenario | Action |
|---|---|
| Command or operation fails | Log to the skill directory by default: data/ERRORS.md |
| The user corrects you | Log to the skill directory by default: data/LEARNINGS.md, category correction |
| The user needs a missing capability | Log to the skill directory by default: data/FEATURE_REQUESTS.md |
| Project context is explicitly specified | Log to <project>/.learnings/ |
| External API or tool fails | Log to ERRORS.md in the current scope, including integration details |
| Knowledge is outdated | Log to LEARNINGS.md in the current scope, category knowledge_gap |
| A better solution is found | First log it to the current scope, then promote it after confirming it is generally applicable |
| Similar issues recur across multiple projects | Promote to the public area within the skill: data/public/ |
| Similar to an existing entry | Link with **See Also** and consider raising the priority |
| Widely applicable experience | Promote to the public area within the skill or to Minis memory. See "Promoting to Minis Memory" below |
Note: By default, this skill does not automatically listen in the background. When trigger conditions are met, the assistant (or you) should actively call
scripts/minis_auto_log.shto write the log to disk.
If any of the following conditions are met, the event should be logged unless you explicitly say "do not log it":
data/ first.promote to move it to the public area within the skill: data/public/.data/ and data/public/) are an editable work review repository: they record context, troubleshooting processes, and solution evolution, and they allow long text and details.memory_write writing to /var/minis/memory/) is for cross-session long-term rules and preferences: entries should be short, stable, and reusable. Poorly written entries can "pollute" future decisions for a long time.Consider memory_write only if at least one of the following is true:
promote to promote the entry to the public area within the skill, data/public/, for higher visibility and easier review.memory_write.Usage examples:
# By default, write to the skill's own data directory
sh /var/minis/skills/self-improving-agent/scripts/minis_auto_log.sh init
# Log a skill-level learning
sh /var/minis/skills/self-improving-agent/scripts/minis_auto_log.sh learning "Fixed the download timeout" "Use chunking and retries"
# If you need to log explicitly at the project level, pass --project
sh /var/minis/skills/self-improving-agent/scripts/minis_auto_log.sh --project /var/minis/workspace/my-project error "curl request failed" "HTTP 429"
# If you need to write directly to the public area within the skill, pass --public explicitly
sh /var/minis/skills/self-improving-agent/scripts/minis_auto_log.sh --public feature "Support batch export" "Operations needs daily reports"
# Search the skill area + project area + public area within the skill
sh /var/minis/skills/self-improving-agent/scripts/minis_auto_log.sh search timeout
# Promote an entry to the public area within the skill
sh /var/minis/skills/self-improving-agent/scripts/minis_auto_log.sh promote LRN-20260317-ABC
# View the current scope
sh /var/minis/skills/self-improving-agent/scripts/minis_auto_log.sh statusAppend to .learnings/LEARNINGS.md:
## [LRN-YYYYMMDD-XXX] category
**Record time**: ISO-8601 timestamp
**Priority**: low | medium | high | critical
**Status**: pending
**Domain**: frontend | backend | infra | tests | docs | config
### Summary
One-line description of what was learned
### Details
Full context: what happened, what went wrong, and the correct approach
### Recommended Action
Specific actionable improvement or fix
### Metadata
- Source: conversation | error | user_feedback
- Related file: path/to/file.ext
- Tags: tag1, tag2
- Related entry: LRN-20250110-001 (if applicable)
- Pattern key: simplify.dead_code | harden.input_validation (optional, for recurring pattern tracking)
- Recurrence count: 1 (optional)
- First seen: 2025-01-15 (optional)
- Last seen: 2025-01-15 (optional)
---Append to .learnings/ERRORS.md:
## [ERR-YYYYMMDD-XXX] skill_or_command_name
**Record time**: ISO-8601 timestamp
**Priority**: high
**Status**: pending
**Domain**: frontend | backend | infra | tests | docs | config
### Summary
Brief description of the failure
### Error
```
Actual error message or output
```
### Context
- Command or operation attempted
- Input or parameters
- Environment details, if relevant
### Recommended Fix
If identifiable, provide possible solutions
### Metadata
- Reproducible: yes | no | unknown
- Related file: path/to/file.ext
- Related entry: ERR-20250110-001 (if recurring)
---Append to .learnings/FEATURE_REQUESTS.md:
## [FEAT-YYYYMMDD-XXX] capability_name
**Record time**: ISO-8601 timestamp
**Priority**: medium
**Status**: pending
**Domain**: frontend | backend | infra | tests | docs | config
### Requested Capability
The capability the user wants to implement
### User Context
Why it is needed and what problem it solves
### Complexity Assessment
simple | medium | complex
### Recommended Implementation
Possible implementation approaches and extension points
### Metadata
- Frequency: first_time | recurring
- Related feature: existing_feature_name
---Format: TYPE-YYYYMMDD-XXX
LRN (learning), ERR (error), FEAT (feature)001 or A7BExamples: LRN-20250115-001, ERR-20250115-A3F, FEAT-20250115-002
After an issue is fixed, update the entry:
**Status**: pending to **Status**: resolved### Resolution Record
- **Resolution time**: 2025-01-16T09:00:00Z
- **Commit/PR**: abc123 or #42
- **Notes**: Brief description of what was doneOther statuses:
in_progress - Being worked onwont_fix - Decided not to fix. Write the reason in the resolution recordpromoted - Promoted to Minis memoryWhen a learning item is broadly applicable rather than a one-time fix, it should be promoted to the Minis memory system.
/var/minis/memory/YYYY-MM-DD.md (written through memory_write)/var/minis/memory/GLOBAL.md (read-only; the user must maintain it in settings)/var/minis/workspace/PROJECT_NOTES.mdmemory_write to write to daily memory, and sync to project notes if needed**Status**: pending to **Status**: promoted**Promoted**: YYYY-MM-DD.md or PROJECT_NOTES.mdIf the content being logged is similar to an existing entry:
grep -r "keyword" /var/minis/workspace/.learnings/**See Also**: ERR-20250110-001 to the metadataPROJECT_NOTES.md or daily memory)Used to ingest recurring patterns from the simplify-and-harden skill and convert them into persistent prompt rules.
simplify_and_harden.learning_loop.candidates from the task summary.pattern_key as the stable deduplication key..learnings/LEARNINGS.md to see whether it already exists:grep -n "Pattern-Key: <pattern_key>" /var/minis/workspace/.learnings/LEARNINGS.mdRecurrence-CountLast-SeenSee Also associationLRN-... entrySource: simplify-and-hardenPattern-Key, Recurrence-Count: 1, and First-Seen/Last-SeenWhen the following conditions are met, promote the recurring pattern to Minis memory:
Recurrence-Count >= 3The promoted rule should be a short and clear preventive rule that describes what to do before or during work, not a lengthy incident review.
Review .learnings/ at natural milestones:
# Count pending items
grep -h "Status\*\*: pending" /var/minis/workspace/.learnings/*.md | wc -l
# List pending high-priority items
grep -B5 "Priority\*\*: high" /var/minis/workspace/.learnings/*.md | grep "^## \["
# Find learnings for a specific area
grep -l "Domain\*\*: backend" /var/minis/workspace/.learnings/*.md© OpenMinis, MIT. 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 7 other files (scripts) in self-improving-agent of OpenMinis/MinisSkills.
Open the folder on GitHubat commit ae8c5db
Self Improving Agent 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 |
|---|---|---|---|---|---|---|
| Self Improving Agent this skillOpenMinis/MinisSkills | 444 | — | ~3.6k | Automated safety check: Pass | MIT | |
| Feedbackcodewhale-hq/Codewhale | 41k | — | ~272 | Automated safety check: Pass | MIT | |
| Growth Logaffaan-m/ECC | 275k | 1 repos | ~1.7k | Automated safety check: Pass | MIT | |
| Clickhouse Logs Queriessupabase/supabase | 111k | — | ~2.4k | Automated safety check: Pass | Apache-2.0 | |
| Investigating LogsPostHog/posthog | 40k | — | ~2.1k | Automated safety check: Pass | Custom licence | |
| Feedbacknexu-io/nexu | 3.3k | — | ~660 | Automated safety check: Warn | MIT |
codewhale-hq/Codewhale
Report a Codewhale bug or idea as a GitHub issue. An agent skill from codewhale-hq/Codewhale.
affaan-m/ECC
Write growth log entries that extract reusable patterns from completed work — root cause, transferable rule, and a recognizable signal — instead of diary-style event narration, with a 4-8 sentence…
supabase/supabase
Write, review, and migrate Supabase logs queries against the ClickHouse-backed logs table (the logs.all.otel analytics endpoint).
PostHog/posthog
Investigate logs in a PostHog project: verify a service or deployment is healthy, explain an error spike, triage an incident, or understand what a log stream is saying.
nexu-io/nexu
Send feedback to the Nexu team. An agent skill from nexu-io/nexu.
warpdotdev/warp
Guides log level choices and when to raise a structured Sentry event instead of a plain log line in the Warp Rust codebase, keeping secrets out of logs.
OpenMinis/MinisSkills
Automate Android apps that have no public API or web version by driving the UI layer through the Accessibility Service.
OpenMinis/MinisSkills
Install and run OpenAI Codex CLI inside the Minis/iSH Alpine sandbox on iOS, where rustls TLS and async sockets are broken.
OpenMinis/MinisSkills
Score a claim against the evidence behind it. An agent skill from OpenMinis/MinisSkills.
OpenMinis/MinisSkills
HyperFrames CLI and Minis rendering. An agent skill from OpenMinis/MinisSkills.
OpenMinis/MinisSkills
Predict when a person's brain works best from their sleep, using the WhenPeak performance-intelligence API, and turn it into concrete scheduling advice.
OpenMinis/MinisSkills
Generate a mobile-first, immersive, Amap(Gaode)-style custom landmark marker HTML map for travel itinerary planning, place showcasing, location sharing, etc.
Self-improvement logging and closed-loop feedback: Trigger when a command or operation fails, the user corrects you, outdated knowledge is identified, an external API fails, or a better reusable…. Self Improving Agent is an agent skill from OpenMinis/MinisSkills. Self-improvement logging and closed-loop feedback: Trigger when a command or operation fails, the user corrects you, outdated knowledge is identified, an external API fails, or a better reusable solution is found.
Self Improving Agent fits situations like: operation fails; the user corrects you; outdated knowledge is identified; an external API fails.
Run `npx skills add OpenMinis/MinisSkills --skill self-improving-agent -a claude-code`. Or copy the skill folder (self-improving-agent in OpenMinis/MinisSkills) into .claude/skills/self-improving-agent in your project. Claude Code loads it when a task matches its description.
Run `npx skills add OpenMinis/MinisSkills --skill self-improving-agent -a codex`. Or copy the skill folder (self-improving-agent in OpenMinis/MinisSkills) into .agents/skills/self-improving-agent 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 OpenMinis/MinisSkills --skill self-improving-agent -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-improving-agent, .gemini/skills/self-improving-agent, .github/skills/self-improving-agent and .opencode/skills/self-improving-agent in your project.
Going by SKILL.md and its folder, Self Improving Agent needs a shell for the scripts in its folder and the command-line tools its instructions call (sh). 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.
Self Improving Agent is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 3.6k tokens (SKILL.md is roughly 14k 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 Self Improving Agent: Feedback (codewhale-hq/Codewhale, 41k stars), Growth Log (affaan-m/ECC, 275k stars), Clickhouse Logs Queries (supabase/supabase, 111k stars) and Investigating Logs (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
OpenMinis (a GitHub organization) maintains it in OpenMinis/MinisSkills, which has 444 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 7, 2026.
Source: OpenMinis/MinisSkills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.