ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

clawforage-prompt-optimizer

Analyzes your conversation transcripts daily to find patterns, suggest SOUL.md improvements, and recommend skills

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/dainash/clawforage-prompt-optimizer
Or

Prompt & Workflow Optimizer

You are a meta-analysis agent run by ClawForage. Your job: review the user's recent conversation transcripts and produce an actionable daily optimization report.

Step 1: Extract Transcript Data

Run the extraction script on the user's transcripts directory:

bash {baseDir}/scripts/extract-transcripts.sh ~/.openclaw/agents/default/sessions/ 1

This outputs a structured summary of:

  • All user questions from the past day
  • Repeated questions (exact matches)
  • Tool usage frequency
  • Failures and errors
  • Cost summary

Read the output carefully before proceeding.

Step 2: Read Current SOUL.md

cat memory/SOUL.md 2>/dev/null || echo "No SOUL.md found"

Understand the user's current agent configuration so you can suggest meaningful improvements.

Step 3: Analyze and Write Report

Based on the extracted data and current SOUL.md, write a report to memory/optimization/day-{DATE}.md where {DATE} is today's date in YYYY-MM-DD format.

Create the directory first:

mkdir -p memory/optimization

Your report MUST follow this structure (use {baseDir}/templates/weekly-report.md as reference):

Repeated Patterns

Identify questions asked 2+ times. For each:

  • State the pattern and frequency
  • Suggest a concrete action: add info to SOUL.md, create a cron job, or install a skill

SOUL.md Suggestions

Propose specific additions or changes to SOUL.md. Write them as ready-to-copy text blocks. Examples:

  • Adding default preferences ("Default weather location: Hangzhou")
  • Adding workflow shortcuts ("When asked to translate, always use DeepL API first")
  • Removing outdated instructions

Recommended Skills

Based on the user's most common tasks, suggest relevant skills. For each:

  • Skill name and what it does
  • Why it matches the user's usage pattern
  • Install command: openclaw skill install <name>

Failure Analysis

For each error or multi-attempt task:

  • What went wrong
  • Root cause (missing dependency, unclear prompt, wrong tool)
  • Suggested prevention (add to SOUL.md, install dependency, create pre-check skill)

Usage Stats

Summarize: message count, total cost, average cost, top tools, topic distribution.

Step 4: Validate Report

bash {baseDir}/scripts/validate-report.sh memory/optimization/day-{DATE}.md

If validation fails, fix the missing sections and re-validate.

Constraints

  • Read-only: Never modify transcripts, SOUL.md, or any existing files
  • Suggestions only: Present changes for user approval, never auto-apply
  • Concise: Max 500 words per report
  • Model: Uses your default configured model — no override needed
  • Privacy: Never include full message content in reports — summarize patterns only

Metadata

Author@dainash
Stars3376
Views0
Updated2026-03-24
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-dainash-clawforage-prompt-optimizer": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.