Merge pull request #916 from alirezarezvani/dev
Some checks failed
Deploy Documentation to Pages / build (push) Has been cancelled
Sync Codex Skills Symlinks / sync (push) Has been cancelled
Deploy Documentation to Pages / deploy (push) Has been cancelled

Dev
This commit is contained in:
Alireza Rezvani 2026-07-14 09:46:55 +02:00 committed by GitHub
commit 84dc5a4f6a
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
24 changed files with 115 additions and 91 deletions

View file

@ -420,8 +420,8 @@
{
"name": "self-improving-agent",
"source": "./engineering-team/self-improving-agent",
"description": "Curate auto-memory, promote learnings to CLAUDE.md and rules, extract patterns into skills. Ships 5 slash commands (/si:review, /si:promote, /si:extract, /si:status, /si:remember) and 2 sub-agents (memory-analyst, skill-extractor).",
"version": "2.9.0",
"description": "Curate auto-memory, promote learnings to CLAUDE.md and rules, extract patterns into skills. Ships 5 slash commands (/si:memory-review, /si:promote, /si:extract, /si:memory-status, /si:remember) and 2 sub-agents (memory-analyst, skill-extractor).",
"version": "2.9.1",
"author": {
"name": "Alireza Rezvani"
},

View file

@ -737,6 +737,18 @@
"category": "engineering",
"description": ">-"
},
{
"name": "memory-review",
"source": "../../engineering-team/self-improving-agent/skills/memory-review",
"category": "engineering",
"description": "Analyze auto-memory for promotion candidates, stale entries, consolidation opportunities, and health metrics. Use when the user runs /si:memory-review or asks what has been learned and what should be promoted or pruned."
},
{
"name": "memory-status",
"source": "../../engineering-team/self-improving-agent/skills/memory-status",
"category": "engineering",
"description": "Memory health dashboard showing line counts, topic files, capacity, stale entries, and recommendations. Use when the user runs /si:memory-status or asks how full or healthy the agent memory is."
},
{
"name": "migrate",
"source": "../../engineering-team/playwright-pro/skills/migrate",
@ -791,12 +803,6 @@
"category": "engineering",
"description": ">-"
},
{
"name": "review",
"source": "../../engineering-team/self-improving-agent/skills/review",
"category": "engineering",
"description": "Analyze auto-memory for promotion candidates, stale entries, consolidation opportunities, and health metrics. Use when the user runs /si:review or asks what has been learned and what should be promoted or pruned."
},
{
"name": "security-pen-testing",
"source": "../../engineering-team/skills/security-pen-testing",
@ -893,12 +899,6 @@
"category": "engineering",
"description": "Use when writing Snowflake SQL, building data pipelines with Dynamic Tables or Streams/Tasks, using Cortex AI functions, creating Cortex Agents, writing Snowpark Python, configuring dbt for Snowflake, or troubleshooting Snowflake errors."
},
{
"name": "status",
"source": "../../engineering-team/self-improving-agent/skills/status",
"category": "engineering",
"description": "Memory health dashboard showing line counts, topic files, capacity, stale entries, and recommendations. Use when the user runs /si:status or asks how full or healthy the agent memory is."
},
{
"name": "stripe-integration-expert",
"source": "../../engineering-team/skills/stripe-integration-expert",

1
.codex/skills/memory-review Symbolic link
View file

@ -0,0 +1 @@
../../engineering-team/self-improving-agent/skills/memory-review

1
.codex/skills/memory-status Symbolic link
View file

@ -0,0 +1 @@
../../engineering-team/self-improving-agent/skills/memory-status

View file

@ -1 +1 @@
../../engineering-team/self-improving-agent/skills/review
../../engineering-team/playwright-pro/skills/review

View file

@ -1,7 +1,7 @@
{
"version": "1.0.0",
"name": "gemini-cli-skills",
"total_skills": 418,
"total_skills": 420,
"skills": [
{
"name": "README",
@ -938,6 +938,16 @@
"category": "engineering",
"description": "Use when a security incident has been detected or declared and needs classification, triage, escalation path determination, and forensic evidence collection. Covers SEV1-SEV4 classification, false positive filtering, incident taxonomy, and NIST SP 800-61 lifecycle."
},
{
"name": "memory-review",
"category": "engineering",
"description": "Analyze auto-memory for promotion candidates, stale entries, consolidation opportunities, and health metrics. Use when the user runs /si:memory-review or asks what has been learned and what should be promoted or pruned."
},
{
"name": "memory-status",
"category": "engineering",
"description": "Memory health dashboard showing line counts, topic files, capacity, stale entries, and recommendations. Use when the user runs /si:memory-status or asks how full or healthy the agent memory is."
},
{
"name": "migrate",
"category": "engineering",
@ -976,7 +986,7 @@
{
"name": "review",
"category": "engineering",
"description": "Analyze auto-memory for promotion candidates, stale entries, consolidation opportunities, and health metrics. Use when the user runs /si:review or asks what has been learned and what should be promoted or pruned."
"description": ">-"
},
{
"name": "security-pen-testing",

View file

@ -0,0 +1 @@
../../../engineering-team/self-improving-agent/skills/memory-review/SKILL.md

View file

@ -0,0 +1 @@
../../../engineering-team/self-improving-agent/skills/memory-status/SKILL.md

View file

@ -1 +1 @@
../../../engineering-team/self-improving-agent/skills/review/SKILL.md
../../../engineering-team/playwright-pro/skills/review/SKILL.md

View file

@ -381,7 +381,7 @@ MIT — see [LICENSE](LICENSE) for details.
## Star History
[![Star History Chart](https://api.star-history.com/svg?repos=alirezarezvani/claude-skills&type=Date)](https://star-history.com/#alirezarezvani/claude-skills&Date)
[Star History Chart](https://www.star-history.com/?type=date&repos=alirezarezvani%2Fclaude-skills)
---

View file

@ -1,7 +1,7 @@
{
"name": "si",
"version": "2.9.0",
"description": "Self-Improving Agent: curate auto-memory, promote learnings to CLAUDE.md and rules, extract proven patterns into reusable skills. Provides /si:review, /si:promote, /si:extract, /si:status, and /si:remember slash commands.",
"version": "2.9.1",
"description": "Self-Improving Agent: curate auto-memory, promote learnings to CLAUDE.md and rules, extract proven patterns into reusable skills. Provides /si:memory-review, /si:promote, /si:extract, /si:memory-status, and /si:remember slash commands.",
"author": {
"name": "Alireza Rezvani",
"url": "https://alirezarezvani.com"

View file

@ -6,10 +6,10 @@ This plugin helps you curate Claude Code's auto-memory into durable project know
Use the `/si:` namespace for all commands:
- `/si:review` — Analyze auto-memory health and find promotion candidates
- `/si:memory-review` — Analyze auto-memory health and find promotion candidates
- `/si:promote <pattern>` — Graduate a learning to CLAUDE.md or `.claude/rules/`
- `/si:extract <pattern>` — Create a reusable skill from a proven pattern
- `/si:status` — Quick memory health dashboard
- `/si:memory-status` — Quick memory health dashboard
- `/si:remember <knowledge>` — Explicitly save something to auto-memory
## How auto-memory works
@ -22,7 +22,7 @@ This plugin reads that directory — it never creates its own storage.
### After completing a feature or debugging session
```
/si:review
/si:memory-review
```
Check if anything Claude learned should become a permanent rule.
@ -40,7 +40,7 @@ Creates a standalone skill with SKILL.md, ready to install elsewhere.
### To check memory capacity
```
/si:status
/si:memory-status
```
Shows line counts, topic files, stale entries, and recommendations.
@ -55,7 +55,7 @@ Shows line counts, topic files, stale entries, and recommendations.
## Agents
- **memory-analyst**: Spawned by `/si:review` to analyze patterns across memory files
- **memory-analyst**: Spawned by `/si:memory-review` to analyze patterns across memory files
- **skill-extractor**: Spawned by `/si:extract` to generate complete skill packages
## Hooks

View file

@ -18,10 +18,10 @@ Promoting a pattern from memory to rules fundamentally changes how Claude treats
| Command | What it does |
|---------|-------------|
| `/si:review` | Analyze auto-memory — find promotion candidates, stale entries, health metrics |
| `/si:memory-review` | Analyze auto-memory — find promotion candidates, stale entries, health metrics |
| `/si:promote` | Graduate a pattern from MEMORY.md → CLAUDE.md or `.claude/rules/` |
| `/si:extract` | Turn a recurring pattern into a standalone reusable skill |
| `/si:status` | Memory health dashboard — line counts, capacity, recommendations |
| `/si:memory-status` | Memory health dashboard — line counts, capacity, recommendations |
| `/si:remember` | Explicitly save important knowledge to auto-memory |
## Install
@ -47,7 +47,7 @@ clawhub install self-improving-agent
```
Claude discovers pattern → auto-memory (MEMORY.md)
Pattern recurs 2-3x → /si:review flags it
Pattern recurs 2-3x → /si:memory-review flags it
You approve → /si:promote graduates it to CLAUDE.md

View file

@ -1,6 +1,6 @@
---
name: memory-analyst
description: Read-only analyst for `~/.claude/projects/<project>/memory/`. Identifies promotion candidates (entries proven enough for CLAUDE.md), stale references, consolidation opportunities, conflicts with existing CLAUDE.md rules, and reports health metrics (capacity, freshness, organization). Spawned by `/si:review`.
description: Read-only analyst for `~/.claude/projects/<project>/memory/`. Identifies promotion candidates (entries proven enough for CLAUDE.md), stale references, consolidation opportunities, conflicts with existing CLAUDE.md rules, and reports health metrics (capacity, freshness, organization). Spawned by `/si:memory-review`.
tools: Read, Glob, Grep
model: inherit
maxTurns: 30
@ -72,7 +72,7 @@ Organize findings into:
## Output Format
Use the format defined in the `/si:review` skill. Be specific — include line numbers, exact text, and concrete suggestions.
Use the format defined in the `/si:memory-review` skill. Be specific — include line numbers, exact text, and concrete suggestions.
## Constraints

View file

@ -113,7 +113,7 @@ cat << EOF
Command error detected (pattern: "$matched_pattern").
If this was unexpected or required investigation to fix, save the solution:
/si:remember "explanation of what went wrong and the fix"
Or if this is a known pattern, check: /si:review
Or if this is a known pattern, check: /si:memory-review
Context: $(echo "$error_context" | head -2 | tr '\n' ' ' | cut -c1-200)
</error-detected>
EOF

View file

@ -103,7 +103,7 @@ When entries conflict:
```
Auto-memory captures → This plugin curates → CLAUDE.md enforces
MEMORY.md (raw notes) → /si:review (analyze) → /si:promote (graduate)
MEMORY.md (raw notes) → /si:memory-review (analyze) → /si:promote (graduate)
CLAUDE.md or
.claude/rules/
@ -128,4 +128,4 @@ MEMORY.md (raw notes) → /si:review (analyze) → /si:promote (graduate)
3. **Don't duplicate** — if it's in CLAUDE.md, remove it from MEMORY.md
4. **Scope rules** — use `.claude/rules/` with paths for file-type-specific patterns
5. **Review quarterly** — memory files go stale after refactors
6. **Use /si:status** — monitor capacity before it becomes a problem
6. **Use /si:memory-status** — monitor capacity before it becomes a problem

View file

@ -74,10 +74,10 @@ When promoting, transform the learning:
## Promotion Workflow
```
1. /si:review identifies candidate
1. /si:memory-review identifies candidate
2. Confirm the pattern is still valid
3. Distill into one-line instruction
4. /si:promote writes to CLAUDE.md or rules/
5. Remove from MEMORY.md
6. Verify with /si:status
6. Verify with /si:memory-status
```

View file

@ -10,10 +10,10 @@
"tags": ["memory", "auto-memory", "self-improvement", "learning", "rules", "skills"],
"repository": "https://github.com/alirezarezvani/claude-skills",
"commands": {
"review": "/si:review",
"memory-review": "/si:memory-review",
"promote": "/si:promote",
"extract": "/si:extract",
"status": "/si:status",
"memory-status": "/si:memory-status",
"remember": "/si:remember"
},
"hooks": {

View file

@ -1,19 +1,19 @@
---
name: "review"
description: "Analyze auto-memory for promotion candidates, stale entries, consolidation opportunities, and health metrics. Use when the user runs /si:review or asks what has been learned and what should be promoted or pruned."
name: "memory-review"
description: "Analyze auto-memory for promotion candidates, stale entries, consolidation opportunities, and health metrics. Use when the user runs /si:memory-review or asks what has been learned and what should be promoted or pruned."
---
# /si:review — Analyze Auto-Memory
# /si:memory-review — Analyze Auto-Memory
Performs a comprehensive audit of Claude Code's auto-memory and produces actionable recommendations.
## Usage
```
/si:review # Full review
/si:review --quick # Summary only (counts + top 3 candidates)
/si:review --stale # Focus on stale/outdated entries
/si:review --candidates # Show only promotion candidates
/si:memory-review # Full review
/si:memory-review --quick # Summary only (counts + top 3 candidates)
/si:memory-review --stale # Focus on stale/outdated entries
/si:memory-review --candidates # Show only promotion candidates
```
## What It Does
@ -113,14 +113,14 @@ Memory Health:
## When to Use
- After completing a major feature or debugging session
- When `/si:status` shows MEMORY.md is over 150 lines
- When `/si:memory-status` shows MEMORY.md is over 150 lines
- Weekly during active development
- Before starting a new project phase
- After onboarding a new team member (review what Claude learned)
## Tips
- Run `/si:review --quick` frequently (low overhead)
- Run `/si:memory-review --quick` frequently (low overhead)
- Full review is most valuable when MEMORY.md is getting crowded
- Act on promotion candidates promptly — they're proven patterns
- Don't hesitate to delete stale entries — auto-memory will re-learn if needed

View file

@ -1,17 +1,17 @@
---
name: "status"
description: "Memory health dashboard showing line counts, topic files, capacity, stale entries, and recommendations. Use when the user runs /si:status or asks how full or healthy the agent memory is."
name: "memory-status"
description: "Memory health dashboard showing line counts, topic files, capacity, stale entries, and recommendations. Use when the user runs /si:memory-status or asks how full or healthy the agent memory is."
---
# /si:status — Memory Health Dashboard
# /si:memory-status — Memory Health Dashboard
Quick overview of your project's memory state across all memory systems.
## Usage
```
/si:status # Full dashboard
/si:status --brief # One-line summary
/si:memory-status # Full dashboard
/si:memory-status --brief # One-line summary
```
## What It Reports
@ -84,7 +84,7 @@ done
### Brief mode
```
/si:status --brief
/si:memory-status --brief
```
Output: `📊 Memory: {{n}}/200 lines | {{count}} rules | {{status_emoji}} {{status_word}}`
@ -92,12 +92,12 @@ Output: `📊 Memory: {{n}}/200 lines | {{count}} rules | {{status_emoji}} {{sta
## Interpretation
- **Green (< 60%)**: Plenty of room. Auto-memory is working well.
- **Yellow (60-90%)**: Getting full. Consider running `/si:review` to promote or clean up.
- **Red (> 90%)**: Near capacity. Auto-memory may start dropping older entries. Run `/si:review` now.
- **Yellow (60-90%)**: Getting full. Consider running `/si:memory-review` to promote or clean up.
- **Red (> 90%)**: Near capacity. Auto-memory may start dropping older entries. Run `/si:memory-review` now.
## Tips
- Run `/si:status --brief` as a quick check anytime
- If capacity is yellow+, run `/si:review` to identify promotion candidates
- Run `/si:memory-status --brief` as a quick check anytime
- If capacity is yellow+, run `/si:memory-review` to identify promotion candidates
- Stale entries waste space — delete references to files that no longer exist
- Topic files are fine — Claude creates them to keep MEMORY.md under 200 lines

View file

@ -59,7 +59,7 @@ Keep entries concise — one line when possible. Auto-memory entries don't need
If MEMORY.md is over 180 lines, warn the user:
```
⚠️ MEMORY.md is at {{n}}/200 lines. Consider running /si:review to free space.
⚠️ MEMORY.md is at {{n}}/200 lines. Consider running /si:memory-review to free space.
```
### Step 4: Suggest promotion

View file

@ -13,10 +13,10 @@ Claude Code's auto-memory (v2.1.32+) automatically records project patterns, deb
| Command | What it does |
|---------|-------------|
| `/si:review` | Analyze MEMORY.md — find promotion candidates, stale entries, consolidation opportunities |
| `/si:memory-review` | Analyze MEMORY.md — find promotion candidates, stale entries, consolidation opportunities |
| `/si:promote` | Graduate a pattern from MEMORY.md → CLAUDE.md or `.claude/rules/` |
| `/si:extract` | Turn a proven pattern into a standalone skill |
| `/si:status` | Memory health dashboard — line counts, topic files, recommendations |
| `/si:memory-status` | Memory health dashboard — line counts, topic files, recommendations |
| `/si:remember` | Explicitly save important knowledge to auto-memory |
## How It Fits Together
@ -31,7 +31,7 @@ Claude Code's auto-memory (v2.1.32+) automatically records project patterns, deb
│ standards │ + topic files │ + continuity │
│ Full load │ First 200 lines│ Contextual load │
├─────────────┴──────────────────┴────────────────────────┤
│ ↑ /si:promote ↑ /si:review
│ ↑ /si:promote ↑ /si:memory-review
│ Self-Improving Agent (this plugin) │
│ ↓ /si:extract ↓ /si:remember │
├─────────────────────────────────────────────────────────┤
@ -74,7 +74,7 @@ clawhub install self-improving-agent
```
1. Claude discovers pattern → auto-memory (MEMORY.md)
2. Pattern recurs 2-3x → /si:review flags it as promotion candidate
2. Pattern recurs 2-3x → /si:memory-review flags it as promotion candidate
3. You approve → /si:promote graduates it to CLAUDE.md or rules/
4. Pattern becomes an enforced rule, not just a note
5. MEMORY.md entry removed → frees space for new learnings

View file

@ -300,6 +300,34 @@
},
"references": []
},
{
"name": "memory-review",
"path": "engineering-team/self-improving-agent/skills/memory-review",
"description": "Analyze auto-memory for promotion candidates, stale entries, consolidation opportunities, and health metrics. Use when the user runs /si:memory-review or asks what has been learned and what should be promoted or pruned.",
"tools": [],
"agentic_signals": {
"goal_intake": true,
"refusal_gate": false,
"verification": true,
"loop_discipline": false,
"close_out": false
},
"references": []
},
{
"name": "memory-status",
"path": "engineering-team/self-improving-agent/skills/memory-status",
"description": "Memory health dashboard showing line counts, topic files, capacity, stale entries, and recommendations. Use when the user runs /si:memory-status or asks how full or healthy the agent memory is.",
"tools": [],
"agentic_signals": {
"goal_intake": false,
"refusal_gate": false,
"verification": true,
"loop_discipline": false,
"close_out": false
},
"references": []
},
{
"name": "promote",
"path": "engineering-team/self-improving-agent/skills/promote",
@ -328,20 +356,6 @@
},
"references": []
},
{
"name": "review",
"path": "engineering-team/self-improving-agent/skills/review",
"description": "Analyze auto-memory for promotion candidates, stale entries, consolidation opportunities, and health metrics. Use when the user runs /si:review or asks what has been learned and what should be promoted or pruned.",
"tools": [],
"agentic_signals": {
"goal_intake": true,
"refusal_gate": false,
"verification": true,
"loop_discipline": false,
"close_out": false
},
"references": []
},
{
"name": "self-improving-agent",
"path": "engineering-team/self-improving-agent/skills/self-improving-agent",
@ -356,20 +370,6 @@
},
"references": []
},
{
"name": "status",
"path": "engineering-team/self-improving-agent/skills/status",
"description": "Memory health dashboard showing line counts, topic files, capacity, stale entries, and recommendations. Use when the user runs /si:status or asks how full or healthy the agent memory is.",
"tools": [],
"agentic_signals": {
"goal_intake": false,
"refusal_gate": false,
"verification": true,
"loop_discipline": false,
"close_out": false
},
"references": []
},
{
"name": "adversarial-reviewer",
"path": "engineering-team/skills/adversarial-reviewer",

View file

@ -431,7 +431,17 @@ fi
SKILLS_TMP="$(mktemp)"
(
cd "$REPO_ROOT"
find . -mindepth 4 -maxdepth 6 -type f -name 'SKILL.md' -not -path './.git/*' -not -path './integrations/*' | sort
find . -mindepth 4 -maxdepth 6 -type f -name 'SKILL.md' \
-not -path './.git/*' \
-not -path './.claude/*' \
-not -path './.codex/*' \
-not -path './.codex-plugin/*' \
-not -path './.gemini/*' \
-not -path './.hermes/*' \
-not -path './.vibe/*' \
-not -path './integrations/*' \
-not -path './docs/*' \
| sort
) > "$SKILLS_TMP"
TOTAL_CANDIDATES="$(wc -l < "$SKILLS_TMP" | tr -d ' ')"