{
  "schemaVersion": "1.0",
  "item": {
    "slug": "agente-conhecimento",
    "name": "Agente Conhecimento",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/PEDROHENRIQUE202525/agente-conhecimento",
    "canonicalUrl": "https://clawhub.ai/PEDROHENRIQUE202525/agente-conhecimento",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/agente-conhecimento",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agente-conhecimento",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/agente-conhecimento"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/agente-conhecimento",
    "agentPageUrl": "https://openagent3.xyz/skills/agente-conhecimento/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agente-conhecimento/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agente-conhecimento/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Self-Improvement Skill",
        "body": "Log learnings and errors to markdown files for continuous improvement. Coding agents can later process these into fixes, and important learnings get promoted to project memory."
      },
      {
        "title": "Quick Reference",
        "body": "SituationActionCommand/operation failsLog to .learnings/ERRORS.mdUser corrects youLog to .learnings/LEARNINGS.md with category correctionUser wants missing featureLog to .learnings/FEATURE_REQUESTS.mdAPI/external tool failsLog to .learnings/ERRORS.md with integration detailsKnowledge was outdatedLog to .learnings/LEARNINGS.md with category knowledge_gapFound better approachLog to .learnings/LEARNINGS.md with category best_practiceSimilar to existing entryLink with **See Also**, consider priority bumpBroadly applicable learningPromote to CLAUDE.md, AGENTS.md, and/or .github/copilot-instructions.mdWorkflow improvementsPromote to AGENTS.md (OpenClaw workspace)Tool gotchasPromote to TOOLS.md (OpenClaw workspace)Behavioral patternsPromote to SOUL.md (OpenClaw workspace)"
      },
      {
        "title": "OpenClaw Setup (Recommended)",
        "body": "OpenClaw is the primary platform for this skill. It uses workspace-based prompt injection with automatic skill loading."
      },
      {
        "title": "Installation",
        "body": "Via ClawdHub (recommended):\n\nclawdhub install self-improving-agent\n\nManual:\n\ngit clone https://github.com/peterskoett/self-improving-agent.git ~/.openclaw/skills/self-improving-agent"
      },
      {
        "title": "Workspace Structure",
        "body": "OpenClaw injects these files into every session:\n\n~/.openclaw/workspace/\n├── AGENTS.md          # Multi-agent workflows, delegation patterns\n├── SOUL.md            # Behavioral guidelines, personality, principles\n├── TOOLS.md           # Tool capabilities, integration gotchas\n├── MEMORY.md          # Long-term memory (main session only)\n├── memory/            # Daily memory files\n│   └── YYYY-MM-DD.md\n└── .learnings/        # This skill's log files\n    ├── LEARNINGS.md\n    ├── ERRORS.md\n    └── FEATURE_REQUESTS.md"
      },
      {
        "title": "Create Learning Files",
        "body": "mkdir -p ~/.openclaw/workspace/.learnings\n\nThen create the log files (or copy from assets/):\n\nLEARNINGS.md — corrections, knowledge gaps, best practices\nERRORS.md — command failures, exceptions\nFEATURE_REQUESTS.md — user-requested capabilities"
      },
      {
        "title": "Promotion Targets",
        "body": "When learnings prove broadly applicable, promote them to workspace files:\n\nLearning TypePromote ToExampleBehavioral patternsSOUL.md\"Be concise, avoid disclaimers\"Workflow improvementsAGENTS.md\"Spawn sub-agents for long tasks\"Tool gotchasTOOLS.md\"Git push needs auth configured first\""
      },
      {
        "title": "Inter-Session Communication",
        "body": "OpenClaw provides tools to share learnings across sessions:\n\nsessions_list — View active/recent sessions\nsessions_history — Read another session's transcript\nsessions_send — Send a learning to another session\nsessions_spawn — Spawn a sub-agent for background work"
      },
      {
        "title": "Optional: Enable Hook",
        "body": "For automatic reminders at session start:\n\n# Copy hook to OpenClaw hooks directory\ncp -r hooks/openclaw ~/.openclaw/hooks/self-improvement\n\n# Enable it\nopenclaw hooks enable self-improvement\n\nSee references/openclaw-integration.md for complete details."
      },
      {
        "title": "Generic Setup (Other Agents)",
        "body": "For Claude Code, Codex, Copilot, or other agents, create .learnings/ in your project:\n\nmkdir -p .learnings\n\nCopy templates from assets/ or create files with headers."
      },
      {
        "title": "Learning Entry",
        "body": "Append to .learnings/LEARNINGS.md:\n\n## [LRN-YYYYMMDD-XXX] category\n\n**Logged**: ISO-8601 timestamp\n**Priority**: low | medium | high | critical\n**Status**: pending\n**Area**: frontend | backend | infra | tests | docs | config\n\n### Summary\nOne-line description of what was learned\n\n### Details\nFull context: what happened, what was wrong, what's correct\n\n### Suggested Action\nSpecific fix or improvement to make\n\n### Metadata\n- Source: conversation | error | user_feedback\n- Related Files: path/to/file.ext\n- Tags: tag1, tag2\n- See Also: LRN-20250110-001 (if related to existing entry)\n\n---"
      },
      {
        "title": "Error Entry",
        "body": "Append to .learnings/ERRORS.md:\n\n## [ERR-YYYYMMDD-XXX] skill_or_command_name\n\n**Logged**: ISO-8601 timestamp\n**Priority**: high\n**Status**: pending\n**Area**: frontend | backend | infra | tests | docs | config\n\n### Summary\nBrief description of what failed\n\n### Error\n\nActual error message or output\n\n### Context\n- Command/operation attempted\n- Input or parameters used\n- Environment details if relevant\n\n### Suggested Fix\nIf identifiable, what might resolve this\n\n### Metadata\n- Reproducible: yes | no | unknown\n- Related Files: path/to/file.ext\n- See Also: ERR-20250110-001 (if recurring)\n\n---"
      },
      {
        "title": "Feature Request Entry",
        "body": "Append to .learnings/FEATURE_REQUESTS.md:\n\n## [FEAT-YYYYMMDD-XXX] capability_name\n\n**Logged**: ISO-8601 timestamp\n**Priority**: medium\n**Status**: pending\n**Area**: frontend | backend | infra | tests | docs | config\n\n### Requested Capability\nWhat the user wanted to do\n\n### User Context\nWhy they needed it, what problem they're solving\n\n### Complexity Estimate\nsimple | medium | complex\n\n### Suggested Implementation\nHow this could be built, what it might extend\n\n### Metadata\n- Frequency: first_time | recurring\n- Related Features: existing_feature_name\n\n---"
      },
      {
        "title": "ID Generation",
        "body": "Format: TYPE-YYYYMMDD-XXX\n\nTYPE: LRN (learning), ERR (error), FEAT (feature)\nYYYYMMDD: Current date\nXXX: Sequential number or random 3 chars (e.g., 001, A7B)\n\nExamples: LRN-20250115-001, ERR-20250115-A3F, FEAT-20250115-002"
      },
      {
        "title": "Resolving Entries",
        "body": "When an issue is fixed, update the entry:\n\nChange **Status**: pending → **Status**: resolved\nAdd resolution block after Metadata:\n\n### Resolution\n- **Resolved**: 2025-01-16T09:00:00Z\n- **Commit/PR**: abc123 or #42\n- **Notes**: Brief description of what was done\n\nOther status values:\n\nin_progress - Actively being worked on\nwont_fix - Decided not to address (add reason in Resolution notes)\npromoted - Elevated to CLAUDE.md, AGENTS.md, or .github/copilot-instructions.md"
      },
      {
        "title": "Promoting to Project Memory",
        "body": "When a learning is broadly applicable (not a one-off fix), promote it to permanent project memory."
      },
      {
        "title": "When to Promote",
        "body": "Learning applies across multiple files/features\nKnowledge any contributor (human or AI) should know\nPrevents recurring mistakes\nDocuments project-specific conventions"
      },
      {
        "title": "Promotion Targets",
        "body": "TargetWhat Belongs ThereCLAUDE.mdProject facts, conventions, gotchas for all Claude interactionsAGENTS.mdAgent-specific workflows, tool usage patterns, automation rules.github/copilot-instructions.mdProject context and conventions for GitHub CopilotSOUL.mdBehavioral guidelines, communication style, principles (OpenClaw workspace)TOOLS.mdTool capabilities, usage patterns, integration gotchas (OpenClaw workspace)"
      },
      {
        "title": "How to Promote",
        "body": "Distill the learning into a concise rule or fact\nAdd to appropriate section in target file (create file if needed)\nUpdate original entry:\n\nChange **Status**: pending → **Status**: promoted\nAdd **Promoted**: CLAUDE.md, AGENTS.md, or .github/copilot-instructions.md"
      },
      {
        "title": "Promotion Examples",
        "body": "Learning (verbose):\n\nProject uses pnpm workspaces. Attempted npm install but failed.\nLock file is pnpm-lock.yaml. Must use pnpm install.\n\nIn CLAUDE.md (concise):\n\n## Build & Dependencies\n- Package manager: pnpm (not npm) - use `pnpm install`\n\nLearning (verbose):\n\nWhen modifying API endpoints, must regenerate TypeScript client.\nForgetting this causes type mismatches at runtime.\n\nIn AGENTS.md (actionable):\n\n## After API Changes\n1. Regenerate client: `pnpm run generate:api`\n2. Check for type errors: `pnpm tsc --noEmit`"
      },
      {
        "title": "Recurring Pattern Detection",
        "body": "If logging something similar to an existing entry:\n\nSearch first: grep -r \"keyword\" .learnings/\nLink entries: Add **See Also**: ERR-20250110-001 in Metadata\nBump priority if issue keeps recurring\nConsider systemic fix: Recurring issues often indicate:\n\nMissing documentation (→ promote to CLAUDE.md or .github/copilot-instructions.md)\nMissing automation (→ add to AGENTS.md)\nArchitectural problem (→ create tech debt ticket)"
      },
      {
        "title": "Periodic Review",
        "body": "Review .learnings/ at natural breakpoints:"
      },
      {
        "title": "When to Review",
        "body": "Before starting a new major task\nAfter completing a feature\nWhen working in an area with past learnings\nWeekly during active development"
      },
      {
        "title": "Quick Status Check",
        "body": "# Count pending items\ngrep -h \"Status\\*\\*: pending\" .learnings/*.md | wc -l\n\n# List pending high-priority items\ngrep -B5 \"Priority\\*\\*: high\" .learnings/*.md | grep \"^## \\[\"\n\n# Find learnings for a specific area\ngrep -l \"Area\\*\\*: backend\" .learnings/*.md"
      },
      {
        "title": "Review Actions",
        "body": "Resolve fixed items\nPromote applicable learnings\nLink related entries\nEscalate recurring issues"
      },
      {
        "title": "Detection Triggers",
        "body": "Automatically log when you notice:\n\nCorrections (→ learning with correction category):\n\n\"No, that's not right...\"\n\"Actually, it should be...\"\n\"You're wrong about...\"\n\"That's outdated...\"\n\nFeature Requests (→ feature request):\n\n\"Can you also...\"\n\"I wish you could...\"\n\"Is there a way to...\"\n\"Why can't you...\"\n\nKnowledge Gaps (→ learning with knowledge_gap category):\n\nUser provides information you didn't know\nDocumentation you referenced is outdated\nAPI behavior differs from your understanding\n\nErrors (→ error entry):\n\nCommand returns non-zero exit code\nException or stack trace\nUnexpected output or behavior\nTimeout or connection failure"
      },
      {
        "title": "Priority Guidelines",
        "body": "PriorityWhen to UsecriticalBlocks core functionality, data loss risk, security issuehighSignificant impact, affects common workflows, recurring issuemediumModerate impact, workaround existslowMinor inconvenience, edge case, nice-to-have"
      },
      {
        "title": "Area Tags",
        "body": "Use to filter learnings by codebase region:\n\nAreaScopefrontendUI, components, client-side codebackendAPI, services, server-side codeinfraCI/CD, deployment, Docker, cloudtestsTest files, testing utilities, coveragedocsDocumentation, comments, READMEsconfigConfiguration files, environment, settings"
      },
      {
        "title": "Best Practices",
        "body": "Log immediately - context is freshest right after the issue\nBe specific - future agents need to understand quickly\nInclude reproduction steps - especially for errors\nLink related files - makes fixes easier\nSuggest concrete fixes - not just \"investigate\"\nUse consistent categories - enables filtering\nPromote aggressively - if in doubt, add to CLAUDE.md or .github/copilot-instructions.md\nReview regularly - stale learnings lose value"
      },
      {
        "title": "Gitignore Options",
        "body": "Keep learnings local (per-developer):\n\n.learnings/\n\nTrack learnings in repo (team-wide):\nDon't add to .gitignore - learnings become shared knowledge.\n\nHybrid (track templates, ignore entries):\n\n.learnings/*.md\n!.learnings/.gitkeep"
      },
      {
        "title": "Hook Integration",
        "body": "Enable automatic reminders through agent hooks. This is opt-in - you must explicitly configure hooks."
      },
      {
        "title": "Quick Setup (Claude Code / Codex)",
        "body": "Create .claude/settings.json in your project:\n\n{\n  \"hooks\": {\n    \"UserPromptSubmit\": [{\n      \"matcher\": \"\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"./skills/self-improvement/scripts/activator.sh\"\n      }]\n    }]\n  }\n}\n\nThis injects a learning evaluation reminder after each prompt (~50-100 tokens overhead)."
      },
      {
        "title": "Full Setup (With Error Detection)",
        "body": "{\n  \"hooks\": {\n    \"UserPromptSubmit\": [{\n      \"matcher\": \"\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"./skills/self-improvement/scripts/activator.sh\"\n      }]\n    }],\n    \"PostToolUse\": [{\n      \"matcher\": \"Bash\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"./skills/self-improvement/scripts/error-detector.sh\"\n      }]\n    }]\n  }\n}"
      },
      {
        "title": "Available Hook Scripts",
        "body": "ScriptHook TypePurposescripts/activator.shUserPromptSubmitReminds to evaluate learnings after tasksscripts/error-detector.shPostToolUse (Bash)Triggers on command errors\n\nSee references/hooks-setup.md for detailed configuration and troubleshooting."
      },
      {
        "title": "Automatic Skill Extraction",
        "body": "When a learning is valuable enough to become a reusable skill, extract it using the provided helper."
      },
      {
        "title": "Skill Extraction Criteria",
        "body": "A learning qualifies for skill extraction when ANY of these apply:\n\nCriterionDescriptionRecurringHas See Also links to 2+ similar issuesVerifiedStatus is resolved with working fixNon-obviousRequired actual debugging/investigation to discoverBroadly applicableNot project-specific; useful across codebasesUser-flaggedUser says \"save this as a skill\" or similar"
      },
      {
        "title": "Extraction Workflow",
        "body": "Identify candidate: Learning meets extraction criteria\nRun helper (or create manually):\n./skills/self-improvement/scripts/extract-skill.sh skill-name --dry-run\n./skills/self-improvement/scripts/extract-skill.sh skill-name\n\n\nCustomize SKILL.md: Fill in template with learning content\nUpdate learning: Set status to promoted_to_skill, add Skill-Path\nVerify: Read skill in fresh session to ensure it's self-contained"
      },
      {
        "title": "Manual Extraction",
        "body": "If you prefer manual creation:\n\nCreate skills/<skill-name>/SKILL.md\nUse template from assets/SKILL-TEMPLATE.md\nFollow Agent Skills spec:\n\nYAML frontmatter with name and description\nName must match folder name\nNo README.md inside skill folder"
      },
      {
        "title": "Extraction Detection Triggers",
        "body": "Watch for these signals that a learning should become a skill:\n\nIn conversation:\n\n\"Save this as a skill\"\n\"I keep running into this\"\n\"This would be useful for other projects\"\n\"Remember this pattern\"\n\nIn learning entries:\n\nMultiple See Also links (recurring issue)\nHigh priority + resolved status\nCategory: best_practice with broad applicability\nUser feedback praising the solution"
      },
      {
        "title": "Skill Quality Gates",
        "body": "Before extraction, verify:\n\nSolution is tested and working\n Description is clear without original context\n Code examples are self-contained\n No project-specific hardcoded values\n Follows skill naming conventions (lowercase, hyphens)"
      },
      {
        "title": "Multi-Agent Support",
        "body": "This skill works across different AI coding agents with agent-specific activation."
      },
      {
        "title": "Claude Code",
        "body": "Activation: Hooks (UserPromptSubmit, PostToolUse)\nSetup: .claude/settings.json with hook configuration\nDetection: Automatic via hook scripts"
      },
      {
        "title": "Codex CLI",
        "body": "Activation: Hooks (same pattern as Claude Code)\nSetup: .codex/settings.json with hook configuration\nDetection: Automatic via hook scripts"
      },
      {
        "title": "GitHub Copilot",
        "body": "Activation: Manual (no hook support)\nSetup: Add to .github/copilot-instructions.md:\n\n## Self-Improvement\n\nAfter solving non-obvious issues, consider logging to `.learnings/`:\n1. Use format from self-improvement skill\n2. Link related entries with See Also\n3. Promote high-value learnings to skills\n\nAsk in chat: \"Should I log this as a learning?\"\n\nDetection: Manual review at session end"
      },
      {
        "title": "OpenClaw",
        "body": "Activation: Workspace injection + inter-agent messaging\nSetup: See \"OpenClaw Setup\" section above\nDetection: Via session tools and workspace files"
      },
      {
        "title": "Agent-Agnostic Guidance",
        "body": "Regardless of agent, apply self-improvement when you:\n\nDiscover something non-obvious - solution wasn't immediate\nCorrect yourself - initial approach was wrong\nLearn project conventions - discovered undocumented patterns\nHit unexpected errors - especially if diagnosis was difficult\nFind better approaches - improved on your original solution"
      },
      {
        "title": "Copilot Chat Integration",
        "body": "For Copilot users, add this to your prompts when relevant:\n\nAfter completing this task, evaluate if any learnings should be logged to .learnings/ using the self-improvement skill format.\n\nOr use quick prompts:\n\n\"Log this to learnings\"\n\"Create a skill from this solution\"\n\"Check .learnings/ for related issues\""
      }
    ],
    "body": "name: agente-conhecimento description: use ela para essas tarefas\nSkill: agente_aprimorador_deconhecimento\nname: self-improvement description: \"Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.\"\nSelf-Improvement Skill\n\nLog learnings and errors to markdown files for continuous improvement. Coding agents can later process these into fixes, and important learnings get promoted to project memory.\n\nQuick Reference\nSituation\tAction\nCommand/operation fails\tLog to .learnings/ERRORS.md\nUser corrects you\tLog to .learnings/LEARNINGS.md with category correction\nUser wants missing feature\tLog to .learnings/FEATURE_REQUESTS.md\nAPI/external tool fails\tLog to .learnings/ERRORS.md with integration details\nKnowledge was outdated\tLog to .learnings/LEARNINGS.md with category knowledge_gap\nFound better approach\tLog to .learnings/LEARNINGS.md with category best_practice\nSimilar to existing entry\tLink with **See Also**, consider priority bump\nBroadly applicable learning\tPromote to CLAUDE.md, AGENTS.md, and/or .github/copilot-instructions.md\nWorkflow improvements\tPromote to AGENTS.md (OpenClaw workspace)\nTool gotchas\tPromote to TOOLS.md (OpenClaw workspace)\nBehavioral patterns\tPromote to SOUL.md (OpenClaw workspace)\nOpenClaw Setup (Recommended)\n\nOpenClaw is the primary platform for this skill. It uses workspace-based prompt injection with automatic skill loading.\n\nInstallation\n\nVia ClawdHub (recommended):\n\nclawdhub install self-improving-agent\n\n\nManual:\n\ngit clone https://github.com/peterskoett/self-improving-agent.git ~/.openclaw/skills/self-improving-agent\n\nWorkspace Structure\n\nOpenClaw injects these files into every session:\n\n~/.openclaw/workspace/\n├── AGENTS.md          # Multi-agent workflows, delegation patterns\n├── SOUL.md            # Behavioral guidelines, personality, principles\n├── TOOLS.md           # Tool capabilities, integration gotchas\n├── MEMORY.md          # Long-term memory (main session only)\n├── memory/            # Daily memory files\n│   └── YYYY-MM-DD.md\n└── .learnings/        # This skill's log files\n    ├── LEARNINGS.md\n    ├── ERRORS.md\n    └── FEATURE_REQUESTS.md\n\nCreate Learning Files\nmkdir -p ~/.openclaw/workspace/.learnings\n\n\nThen create the log files (or copy from assets/):\n\nLEARNINGS.md — corrections, knowledge gaps, best practices\nERRORS.md — command failures, exceptions\nFEATURE_REQUESTS.md — user-requested capabilities\nPromotion Targets\n\nWhen learnings prove broadly applicable, promote them to workspace files:\n\nLearning Type\tPromote To\tExample\nBehavioral patterns\tSOUL.md\t\"Be concise, avoid disclaimers\"\nWorkflow improvements\tAGENTS.md\t\"Spawn sub-agents for long tasks\"\nTool gotchas\tTOOLS.md\t\"Git push needs auth configured first\"\nInter-Session Communication\n\nOpenClaw provides tools to share learnings across sessions:\n\nsessions_list — View active/recent sessions\nsessions_history — Read another session's transcript\nsessions_send — Send a learning to another session\nsessions_spawn — Spawn a sub-agent for background work\nOptional: Enable Hook\n\nFor automatic reminders at session start:\n\n# Copy hook to OpenClaw hooks directory\ncp -r hooks/openclaw ~/.openclaw/hooks/self-improvement\n\n# Enable it\nopenclaw hooks enable self-improvement\n\n\nSee references/openclaw-integration.md for complete details.\n\nGeneric Setup (Other Agents)\n\nFor Claude Code, Codex, Copilot, or other agents, create .learnings/ in your project:\n\nmkdir -p .learnings\n\n\nCopy templates from assets/ or create files with headers.\n\nLogging Format\nLearning Entry\n\nAppend to .learnings/LEARNINGS.md:\n\n## [LRN-YYYYMMDD-XXX] category\n\n**Logged**: ISO-8601 timestamp\n**Priority**: low | medium | high | critical\n**Status**: pending\n**Area**: frontend | backend | infra | tests | docs | config\n\n### Summary\nOne-line description of what was learned\n\n### Details\nFull context: what happened, what was wrong, what's correct\n\n### Suggested Action\nSpecific fix or improvement to make\n\n### Metadata\n- Source: conversation | error | user_feedback\n- Related Files: path/to/file.ext\n- Tags: tag1, tag2\n- See Also: LRN-20250110-001 (if related to existing entry)\n\n---\n\nError Entry\n\nAppend to .learnings/ERRORS.md:\n\n## [ERR-YYYYMMDD-XXX] skill_or_command_name\n\n**Logged**: ISO-8601 timestamp\n**Priority**: high\n**Status**: pending\n**Area**: frontend | backend | infra | tests | docs | config\n\n### Summary\nBrief description of what failed\n\n### Error\n\n\nActual error message or output\n\n\n### Context\n- Command/operation attempted\n- Input or parameters used\n- Environment details if relevant\n\n### Suggested Fix\nIf identifiable, what might resolve this\n\n### Metadata\n- Reproducible: yes | no | unknown\n- Related Files: path/to/file.ext\n- See Also: ERR-20250110-001 (if recurring)\n\n---\n\nFeature Request Entry\n\nAppend to .learnings/FEATURE_REQUESTS.md:\n\n## [FEAT-YYYYMMDD-XXX] capability_name\n\n**Logged**: ISO-8601 timestamp\n**Priority**: medium\n**Status**: pending\n**Area**: frontend | backend | infra | tests | docs | config\n\n### Requested Capability\nWhat the user wanted to do\n\n### User Context\nWhy they needed it, what problem they're solving\n\n### Complexity Estimate\nsimple | medium | complex\n\n### Suggested Implementation\nHow this could be built, what it might extend\n\n### Metadata\n- Frequency: first_time | recurring\n- Related Features: existing_feature_name\n\n---\n\nID Generation\n\nFormat: TYPE-YYYYMMDD-XXX\n\nTYPE: LRN (learning), ERR (error), FEAT (feature)\nYYYYMMDD: Current date\nXXX: Sequential number or random 3 chars (e.g., 001, A7B)\n\nExamples: LRN-20250115-001, ERR-20250115-A3F, FEAT-20250115-002\n\nResolving Entries\n\nWhen an issue is fixed, update the entry:\n\nChange **Status**: pending → **Status**: resolved\nAdd resolution block after Metadata:\n### Resolution\n- **Resolved**: 2025-01-16T09:00:00Z\n- **Commit/PR**: abc123 or #42\n- **Notes**: Brief description of what was done\n\n\nOther status values:\n\nin_progress - Actively being worked on\nwont_fix - Decided not to address (add reason in Resolution notes)\npromoted - Elevated to CLAUDE.md, AGENTS.md, or .github/copilot-instructions.md\nPromoting to Project Memory\n\nWhen a learning is broadly applicable (not a one-off fix), promote it to permanent project memory.\n\nWhen to Promote\nLearning applies across multiple files/features\nKnowledge any contributor (human or AI) should know\nPrevents recurring mistakes\nDocuments project-specific conventions\nPromotion Targets\nTarget\tWhat Belongs There\nCLAUDE.md\tProject facts, conventions, gotchas for all Claude interactions\nAGENTS.md\tAgent-specific workflows, tool usage patterns, automation rules\n.github/copilot-instructions.md\tProject context and conventions for GitHub Copilot\nSOUL.md\tBehavioral guidelines, communication style, principles (OpenClaw workspace)\nTOOLS.md\tTool capabilities, usage patterns, integration gotchas (OpenClaw workspace)\nHow to Promote\nDistill the learning into a concise rule or fact\nAdd to appropriate section in target file (create file if needed)\nUpdate original entry:\nChange **Status**: pending → **Status**: promoted\nAdd **Promoted**: CLAUDE.md, AGENTS.md, or .github/copilot-instructions.md\nPromotion Examples\n\nLearning (verbose):\n\nProject uses pnpm workspaces. Attempted npm install but failed. Lock file is pnpm-lock.yaml. Must use pnpm install.\n\nIn CLAUDE.md (concise):\n\n## Build & Dependencies\n- Package manager: pnpm (not npm) - use `pnpm install`\n\n\nLearning (verbose):\n\nWhen modifying API endpoints, must regenerate TypeScript client. Forgetting this causes type mismatches at runtime.\n\nIn AGENTS.md (actionable):\n\n## After API Changes\n1. Regenerate client: `pnpm run generate:api`\n2. Check for type errors: `pnpm tsc --noEmit`\n\nRecurring Pattern Detection\n\nIf logging something similar to an existing entry:\n\nSearch first: grep -r \"keyword\" .learnings/\nLink entries: Add **See Also**: ERR-20250110-001 in Metadata\nBump priority if issue keeps recurring\nConsider systemic fix: Recurring issues often indicate:\nMissing documentation (→ promote to CLAUDE.md or .github/copilot-instructions.md)\nMissing automation (→ add to AGENTS.md)\nArchitectural problem (→ create tech debt ticket)\nPeriodic Review\n\nReview .learnings/ at natural breakpoints:\n\nWhen to Review\nBefore starting a new major task\nAfter completing a feature\nWhen working in an area with past learnings\nWeekly during active development\nQuick Status Check\n# Count pending items\ngrep -h \"Status\\*\\*: pending\" .learnings/*.md | wc -l\n\n# List pending high-priority items\ngrep -B5 \"Priority\\*\\*: high\" .learnings/*.md | grep \"^## \\[\"\n\n# Find learnings for a specific area\ngrep -l \"Area\\*\\*: backend\" .learnings/*.md\n\nReview Actions\nResolve fixed items\nPromote applicable learnings\nLink related entries\nEscalate recurring issues\nDetection Triggers\n\nAutomatically log when you notice:\n\nCorrections (→ learning with correction category):\n\n\"No, that's not right...\"\n\"Actually, it should be...\"\n\"You're wrong about...\"\n\"That's outdated...\"\n\nFeature Requests (→ feature request):\n\n\"Can you also...\"\n\"I wish you could...\"\n\"Is there a way to...\"\n\"Why can't you...\"\n\nKnowledge Gaps (→ learning with knowledge_gap category):\n\nUser provides information you didn't know\nDocumentation you referenced is outdated\nAPI behavior differs from your understanding\n\nErrors (→ error entry):\n\nCommand returns non-zero exit code\nException or stack trace\nUnexpected output or behavior\nTimeout or connection failure\nPriority Guidelines\nPriority\tWhen to Use\ncritical\tBlocks core functionality, data loss risk, security issue\nhigh\tSignificant impact, affects common workflows, recurring issue\nmedium\tModerate impact, workaround exists\nlow\tMinor inconvenience, edge case, nice-to-have\nArea Tags\n\nUse to filter learnings by codebase region:\n\nArea\tScope\nfrontend\tUI, components, client-side code\nbackend\tAPI, services, server-side code\ninfra\tCI/CD, deployment, Docker, cloud\ntests\tTest files, testing utilities, coverage\ndocs\tDocumentation, comments, READMEs\nconfig\tConfiguration files, environment, settings\nBest Practices\nLog immediately - context is freshest right after the issue\nBe specific - future agents need to understand quickly\nInclude reproduction steps - especially for errors\nLink related files - makes fixes easier\nSuggest concrete fixes - not just \"investigate\"\nUse consistent categories - enables filtering\nPromote aggressively - if in doubt, add to CLAUDE.md or .github/copilot-instructions.md\nReview regularly - stale learnings lose value\nGitignore Options\n\nKeep learnings local (per-developer):\n\n.learnings/\n\n\nTrack learnings in repo (team-wide): Don't add to .gitignore - learnings become shared knowledge.\n\nHybrid (track templates, ignore entries):\n\n.learnings/*.md\n!.learnings/.gitkeep\n\nHook Integration\n\nEnable automatic reminders through agent hooks. This is opt-in - you must explicitly configure hooks.\n\nQuick Setup (Claude Code / Codex)\n\nCreate .claude/settings.json in your project:\n\n{\n  \"hooks\": {\n    \"UserPromptSubmit\": [{\n      \"matcher\": \"\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"./skills/self-improvement/scripts/activator.sh\"\n      }]\n    }]\n  }\n}\n\n\nThis injects a learning evaluation reminder after each prompt (~50-100 tokens overhead).\n\nFull Setup (With Error Detection)\n{\n  \"hooks\": {\n    \"UserPromptSubmit\": [{\n      \"matcher\": \"\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"./skills/self-improvement/scripts/activator.sh\"\n      }]\n    }],\n    \"PostToolUse\": [{\n      \"matcher\": \"Bash\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"./skills/self-improvement/scripts/error-detector.sh\"\n      }]\n    }]\n  }\n}\n\nAvailable Hook Scripts\nScript\tHook Type\tPurpose\nscripts/activator.sh\tUserPromptSubmit\tReminds to evaluate learnings after tasks\nscripts/error-detector.sh\tPostToolUse (Bash)\tTriggers on command errors\n\nSee references/hooks-setup.md for detailed configuration and troubleshooting.\n\nAutomatic Skill Extraction\n\nWhen a learning is valuable enough to become a reusable skill, extract it using the provided helper.\n\nSkill Extraction Criteria\n\nA learning qualifies for skill extraction when ANY of these apply:\n\nCriterion\tDescription\nRecurring\tHas See Also links to 2+ similar issues\nVerified\tStatus is resolved with working fix\nNon-obvious\tRequired actual debugging/investigation to discover\nBroadly applicable\tNot project-specific; useful across codebases\nUser-flagged\tUser says \"save this as a skill\" or similar\nExtraction Workflow\nIdentify candidate: Learning meets extraction criteria\nRun helper (or create manually):\n./skills/self-improvement/scripts/extract-skill.sh skill-name --dry-run\n./skills/self-improvement/scripts/extract-skill.sh skill-name\n\nCustomize SKILL.md: Fill in template with learning content\nUpdate learning: Set status to promoted_to_skill, add Skill-Path\nVerify: Read skill in fresh session to ensure it's self-contained\nManual Extraction\n\nIf you prefer manual creation:\n\nCreate skills/<skill-name>/SKILL.md\nUse template from assets/SKILL-TEMPLATE.md\nFollow Agent Skills spec:\nYAML frontmatter with name and description\nName must match folder name\nNo README.md inside skill folder\nExtraction Detection Triggers\n\nWatch for these signals that a learning should become a skill:\n\nIn conversation:\n\n\"Save this as a skill\"\n\"I keep running into this\"\n\"This would be useful for other projects\"\n\"Remember this pattern\"\n\nIn learning entries:\n\nMultiple See Also links (recurring issue)\nHigh priority + resolved status\nCategory: best_practice with broad applicability\nUser feedback praising the solution\nSkill Quality Gates\n\nBefore extraction, verify:\n\n Solution is tested and working\n Description is clear without original context\n Code examples are self-contained\n No project-specific hardcoded values\n Follows skill naming conventions (lowercase, hyphens)\nMulti-Agent Support\n\nThis skill works across different AI coding agents with agent-specific activation.\n\nClaude Code\n\nActivation: Hooks (UserPromptSubmit, PostToolUse) Setup: .claude/settings.json with hook configuration Detection: Automatic via hook scripts\n\nCodex CLI\n\nActivation: Hooks (same pattern as Claude Code) Setup: .codex/settings.json with hook configuration Detection: Automatic via hook scripts\n\nGitHub Copilot\n\nActivation: Manual (no hook support) Setup: Add to .github/copilot-instructions.md:\n\n## Self-Improvement\n\nAfter solving non-obvious issues, consider logging to `.learnings/`:\n1. Use format from self-improvement skill\n2. Link related entries with See Also\n3. Promote high-value learnings to skills\n\nAsk in chat: \"Should I log this as a learning?\"\n\n\nDetection: Manual review at session end\n\nOpenClaw\n\nActivation: Workspace injection + inter-agent messaging Setup: See \"OpenClaw Setup\" section above Detection: Via session tools and workspace files\n\nAgent-Agnostic Guidance\n\nRegardless of agent, apply self-improvement when you:\n\nDiscover something non-obvious - solution wasn't immediate\nCorrect yourself - initial approach was wrong\nLearn project conventions - discovered undocumented patterns\nHit unexpected errors - especially if diagnosis was difficult\nFind better approaches - improved on your original solution\nCopilot Chat Integration\n\nFor Copilot users, add this to your prompts when relevant:\n\nAfter completing this task, evaluate if any learnings should be logged to .learnings/ using the self-improvement skill format.\n\nOr use quick prompts:\n\n\"Log this to learnings\"\n\"Create a skill from this solution\"\n\"Check .learnings/ for related issues\""
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/PEDROHENRIQUE202525/agente-conhecimento",
    "publisherUrl": "https://clawhub.ai/PEDROHENRIQUE202525/agente-conhecimento",
    "owner": "PEDROHENRIQUE202525",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/agente-conhecimento",
    "downloadUrl": "https://openagent3.xyz/downloads/agente-conhecimento",
    "agentUrl": "https://openagent3.xyz/skills/agente-conhecimento/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agente-conhecimento/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agente-conhecimento/agent.md"
  }
}