Menu
Stop making the same mistakes — turn failures into patterns that prevent recurrence
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/live-neon/skills --skill failure-memoryThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Based on SOC occupation classification
Showing SKILL.md
| name | failure-memory |
| version | 1.5.0 |
| description | Stop making the same mistakes — turn failures into patterns that prevent recurrence |
| author | Live Neon <hello@liveneon.ai> |
| homepage | https://github.com/live-neon/skills/tree/main/agentic/failure-memory |
| repository | leegitw/failure-memory |
| license | MIT |
| tags | ["agentic","memory","learning","self-improving","error-tracking","observability","patterns","adaptive","feedback"] |
| layer | core |
| status | active |
| alias | fm |
| metadata | {"openclaw":{"requires":{"config":"[Truncated]","workspace":"[Truncated]"}}} |
Unified skill for failure detection, observation recording, memory search, and pattern convergence. Consolidates 10 granular skills into a single coherent memory system.
Trigger: 失敗発生 (failure occurred)
Source skills: failure-tracker, observation-recorder, memory-search, topic-tagger, failure-detector, evidence-tier, effectiveness-metrics, pattern-convergence-detector, positive-framer, contextual-injection
openclaw install leegitw/failure-memory
Dependencies: leegitw/context-verifier (for file change detection)
# Install with dependencies
openclaw install leegitw/context-verifier
openclaw install leegitw/failure-memory
Standalone usage: This skill can function independently for basic failure tracking. For full lifecycle management, install the complete suite (see Neon Agentic Suite).
Data handling: This skill operates within your agent's trust boundary. When triggered,
it uses your agent's configured model for failure detection and pattern recording. No external APIs
or third-party services are called. Results are written to .learnings/ in your workspace.
AI systems often make the same mistakes repeatedly — deleting working code, missing edge cases, forgetting context. This skill turns failures into learning by:
.learnings/ directoryThe insight: Systems learn better from consequences than instructions. A failure that happened teaches more than a rule that might apply.
Scope note: Pattern detection operates within the current workspace only. Observations are stored in
.learnings/and searched locally. No cross-project data access occurs.
/fm <sub-command> [arguments]
| Command |
|---|
| CJK |
|---|
| Logic |
|---|
| Trigger |
|---|
/fm detect | 検出 | fail∈{test,user,API}→record | Next Steps (auto) |
/fm record | 記録 | pattern→obs, R++∨C++∨D++ | Next Steps (auto) |
/fm search | 索引 | query(pattern∨tag∨slug)→obs[] | Explicit |
/fm classify | 分類 | obs→tier∈{N=1:弱,N=2:中,N≥3:強} | Explicit |
/fm status | 状態 | eligible:R≥3∧C≥2, recent:30d | Explicit |
/fm refactor | 整理 | obs[]→merge∨split∨restructure | Explicit |
/fm converge | 収束 | pattern[]→detect(similarity≥0.8) | Explicit |
| Argument | Required | Description |
|---|---|---|
| type | Yes | Failure type: test, user, api, error |
| context | No | Additional context for the failure |
| Argument | Required | Description |
|---|---|---|
| pattern | Yes | Pattern description or observation ID |
| counter | No | Counter to increment: R (default), C, or D |
| Argument | Required | Description |
|---|---|---|
| query | Yes | Search pattern, tag, or slug |
| status | No | Filter by status: pending, eligible, all (default) |
| Argument | Required | Description |
|---|---|---|
| observation | Yes | Observation ID or pattern |
| Argument | Required | Description |
|---|---|---|
| --eligible | No | Show only eligible observations (R≥3 ∧ C≥2) |
| --recent | No | Show only observations from last 30 days |
| Argument | Required | Description |
|---|---|---|
| observations | Yes | Comma-separated observation IDs |
| action | Yes | Action: merge, split, restructure |
| Argument | Required | Description |
|---|---|---|
| --threshold | No | Similarity threshold (default: 0.8) |
These patterns indicate when /fm detect should be invoked (user or orchestrator triggers):
| Pattern | Source | Action |
|---|---|---|
test.exit_code != 0 | Tool output | /fm detect test |
| "Actually...", "No, that's wrong" | User message | /fm record correction |
| "I meant...", "Not X, Y" | User message | /fm record correction |
| API 4xx/5xx response | Tool output | /fm detect api |
| "error:", "failed", "Exception" | Tool output | /fm detect error |
| Deployment rollback | CI/CD output | /fm detect deployment |
| Database migration failed | Tool output | /fm detect migration |
[DETECTED] api failure
Pattern: payment-api-timeout
Context: Payment API returned 504 after 30s
Observation: OBS-20260215-002
R: 1 → 3
Status: Eligible for constraint (R≥3)
[DETECTED] deployment failure
Pattern: staging-healthcheck-fail
Context: Staging deployment failed health check on /api/health
Observation: OBS-20260215-003
R: 1 → 2
Status: Monitoring (R<3)
| Counter | Meaning | Updated By |
|---|---|---|
| R (Recurrence) | Auto-detected occurrences | /fm detect, /fm record |
| C (Confirmations) | Human-verified true positives | Human via /fm record C |
| D (Disconfirmations) | Human-verified false positives | Human via /fm record D |
| Tier | Criteria | Meaning |
|---|---|---|
| 弱 (weak) | N=1 | Single occurrence, may be noise |
| 中 (emerging) | N=2 | Pattern emerging, monitor |
| 強 (strong) | N≥3 | Established pattern, actionable |
Observations are tagged with slugs: git-*, test-*, workflow-*, security-*, docs-*, quality-*
prevention_rate: Failures prevented / Total potential failuresfalse_positive_rate: D / (C + D)[DETECTED] test failure
Pattern: lint-before-commit
Observation: OBS-20260215-001
R: 1 → 2
Status: Monitoring (R<3)
=== Failure Memory Status ===
Eligible for constraint (R≥3 ∧ C≥2):
- OBS-20260210-003: lint-before-commit (R=4, C=2, D=0)
- OBS-20260212-007: test-before-push (R=3, C=3, D=1)
Recent (last 30d): 12 observations
Pending review: 3 observations
Configuration is loaded from (in order of precedence):
.openclaw/failure-memory.yaml (OpenClaw standard).claude/failure-memory.yaml (Claude Code compatibility)# .openclaw/failure-memory.yaml
detection:
auto_detect: true # Enable automatic failure detection
patterns: # Custom detection patterns
- "FATAL:"
- "CRITICAL:"
thresholds:
eligibility_R: 3 # Recurrence threshold (default: 3)
eligibility_C: 2 # Confirmation threshold (default: 2)
false_positive_max: 0.2 # Max D/(C+D) ratio (default: 0.2)
| Condition | Behavior |
|---|---|
| Invalid sub-command | List available sub-commands |
| Missing observation ID | Error with usage example |
| No matches found | "No observations match query" |
| Duplicate detection | Increment R counter, don't create new observation |
After invoking this skill:
| Condition | Action |
|---|---|
| R incremented | Check eligibility: R≥3 ∧ C≥2 → notify user |
| R≥3 ∧ C≥2 | Suggest /ce generate for constraint |
| Pattern recurring | Link with See Also, bump priority |
| Always | Update .learnings/ERRORS.md or .learnings/LEARNINGS.md |
This skill reads/writes:
.learnings/
├── ERRORS.md # [ERR-YYYYMMDD-XXX] command failures
├── LEARNINGS.md # [LRN-YYYYMMDD-XXX] corrections, best practices
└── observations/ # Individual observation files
└── OBS-YYYYMMDD-XXX.md
What this skill accesses:
.openclaw/failure-memory.yaml and .claude/failure-memory.yaml.learnings/ (read/write)What this skill does NOT access:
What this skill does NOT do:
Data scope clarification:
.learnings/ within the current workspace onlyDetection trigger clarification:
The "Detection Triggers" table describes patterns that indicate when this skill should be
invoked. The agent can auto-invoke /fm detect when these patterns are detected, or users
can invoke manually. This enables true agentic behavior — failures are captured automatically.
Provenance note:
This skill is developed by Live Neon (https://github.com/live-neon/skills) and published
to ClawHub under the leegitw account. Both refer to the same maintainer.
/fm detect creates or updates observation with R++/fm record supports R, C, D counter updates/fm search finds observations by pattern, tag, or slug/fm classify returns correct tier based on N count/fm status shows eligible observations/fm refactor merges/splits observations correctly/fm converge detects similar patterns (≥0.8 similarity)Consolidated from 10 skills as part of agentic skills consolidation (2026-02-15).