monkilabs/self-improvement
src/orchestrator/skills/self-improvement/SKILL.md
Appends new entries to LESSONS-LEARNED.md via opencastle lesson CLI; searches past lessons for matching errors; proposes skill updates when retry patterns exceed thresholds. Use when consulting or updating LESSONS-LEARNED.md, after task failures, when capturing retrospective insights, or when a retry succeeds.
$ install --global
skillsauthnpx skillsauth add monkilabs/opencastle self-improvementInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 19, 2026, 7:29 AM144.6s2 files scanned
SKILL.md
- name:
- self-improvement
- description:
- Appends new entries to LESSONS-LEARNED.md via opencastle lesson CLI; searches past lessons for matching errors; proposes skill updates when retry patterns exceed thresholds. Use when consulting or updating LESSONS-LEARNED.md, after task failures, when capturing retrospective insights, or when a retry succeeds.
Self-Improvement Protocol
Core Rule
Retry with different approach and it works → document lesson immediately. File: .opencastle/LESSONS-LEARNED.md
Writing a Lesson
⛔ HARD GATE — Use the CLI. Do NOT edit LESSONS-LEARNED.md directly.
opencastle lesson --title "Short descriptive title" --category general --severity high \
--problem "What was observed" --wrong "Failing approach" --correct "Working solution" \
--why "Root cause"
Required: --title, --category, --severity, --problem · Optional: --wrong, --correct, --why
After writing: if lesson reveals gap in skill/instruction file, update that file too (prevents pitfall at source).
Workflow
- Search LESSONS-LEARNED.md for matching entries or similar errors.
- Attempt task with conservative flags/options informed by lessons.
- On failure: retry with modified approach (up to threshold); capture error details, context.
- On success: run
opencastle lessonto record working approach. - Verify:
tail -1 .opencastle/LESSONS-LEARNED.md— confirm entry has title, category, severity. If malformed → re-run with corrected flags. - If lesson indicates needed skill/instruction update: draft change; propose a PR.
Quick search example:
rg "missing CRON_SECRET" .opencastle/LESSONS-LEARNED.md || true
Categories & Severity
Category, severity tables moved to LESSON-CATEGORIES.md. Use that file when tagging lessons.
Quality Rules
- Include exact error messages, commands, tool parameters
- Show wrong and correct approaches — the contrast is actionable
- Explain why (root cause)
- One lesson per entry; code blocks mandatory for commands
Anti-Patterns
Never skip reading lessons · Never fix without documenting · Never write vague entries · Never duplicate · Never defer to end of session
Agent Memory
For expertise tracking, cross-session knowledge graphs, load agent-memory skill.
Related Skills
monkilabs/validation-gates
development
VerifiedTrustedCommunity
Defines 10 sequential validation gates: secret scanning, lint/test/build checks, blast radius analysis, dependency auditing, browser testing, cache management, regression checks, smoke tests. Use when running pre-deploy validation or CI checks, CI/CD pipelines, deployment pipeline validation, pre-merge checks, continuous integration, or pull request validation.
44SKILL.mdUpdated Apr 21, 2026
monkilabs/testing-workflow
development
VerifiedTrustedCommunity
Generates test plans, writes unit/integration/E2E test files, identifies coverage gaps, flags common testing anti-patterns. Use when writing tests, creating test suites, planning test strategies, mocking dependencies, measuring code coverage, or test planning.
44SKILL.mdUpdated Apr 21, 2026
monkilabs/team-lead-reference
development
VerifiedTrustedCommunity
Provides model routing rules, validates delegation prerequisites, supplies cost tracking templates, defines dead-letter queue formats for Team Lead orchestration. Load when assigning tasks to agents, choosing model tiers, starting delegation session, running multi-agent workflow, delegating work, choosing which model to use, or assigning tasks.
44SKILL.mdUpdated Apr 21, 2026
monkilabs/session-checkpoints
testing
VerifiedTrustedCommunity
Saves, restores session state including task progress, file changes, delegation history. Use when saving progress, resuming interrupted work, picking up where you left off, or checkpointing current work.
44SKILL.mdUpdated Apr 21, 2026