{ "schemaVersion": "1.0", "item": { "slug": "openclaw-skill-reviewer", "name": "OpenClaw Skill Reviewer", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/YKaiXu/openclaw-skill-reviewer", "canonicalUrl": "https://clawhub.ai/YKaiXu/openclaw-skill-reviewer", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/openclaw-skill-reviewer", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-skill-reviewer", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "references/best-practices.md", "references/openclaw-specs.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-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.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/openclaw-skill-reviewer" }, "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/openclaw-skill-reviewer", "agentPageUrl": "https://openagent3.xyz/skills/openclaw-skill-reviewer/agent", "manifestUrl": "https://openagent3.xyz/skills/openclaw-skill-reviewer/agent.json", "briefUrl": "https://openagent3.xyz/skills/openclaw-skill-reviewer/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": "Skill Reviewer", "body": "Comprehensive skill review and validation for OpenClaw skills." }, { "title": "Overview", "body": "This skill provides a systematic three-level review process to ensure skills are:\n\nValid - Proper structure and format\nComplete - All required components present\nCorrect - Generated outputs match OpenClaw specifications\nHigh-quality - Follows best practices" }, { "title": "Level 1: Format Validation", "body": "Run automatic validation using package_skill.py:\n\npython3 /home/yupeng/.npm-global/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py \n\nChecks:\n\nYAML frontmatter format and required fields\nSkill naming conventions and directory structure\nDescription completeness and quality\nFile organization and resource references\n\nOutcome: ✅ Valid or ❌ Validation errors" }, { "title": "Level 2: Content Quality Assessment", "body": "Manually review SKILL.md for:\n\nFrontmatter:\n\nname is concise and follows naming conventions\ndescription is comprehensive and includes \"when to use\" information\nNo extraneous fields in YAML\n\nBody Structure:\n\nClear organization (workflow-based, task-based, or reference-based)\nProgressive disclosure pattern (metadata → SKILL.md → references)\nConcise and focused content\nImperative/infinitive form for instructions\n\nWriting Quality:\n\nNo filler or redundant explanations\nConcrete examples and realistic scenarios\nClear guidance on when to read reference files\nAvoids duplication between SKILL.md and references" }, { "title": "Level 3: Functional Verification", "body": "Critical Step - Verify that generated outputs match actual OpenClaw specifications.\n\nFor skills that generate templates:\n\nCompare generated templates with actual OpenClaw specification files\nExample: If skill generates AGENTS.md templates, compare with /home/yupeng/.openclaw/workspace/AGENTS.md\nCheck for missing required sections (session startup, memory workflow, safety rules, group chat etiquette, heartbeat mechanism)\nVerify all critical requirements are present\n\nFor skills with scripts:\n\nTest scripts to ensure they work correctly\nVerify output matches expected format\nCheck error handling\n\nFor skills with references:\n\nVerify reference files are accurate and up-to-date\nCheck that references are properly linked from SKILL.md" }, { "title": "Level 4: Best Practices Check", "body": "Verify the skill follows OpenClaw skill best practices:\n\nProgressive Disclosure:\n\nSKILL.md body is concise (<500 lines preferred)\nDetailed information moved to references/\nReferences are properly linked and described\n\nResource Organization:\n\nOnly necessary resource directories created\nNo extraneous files (README.md, INSTALLATION_GUIDE.md, etc.)\nScripts/ references/ assets/ used appropriately\n\nContext Efficiency:\n\nInformation lives in either SKILL.md OR references, not both\nEssential procedural instructions in SKILL.md\nDetailed reference material in references/\n\nTriggering Accuracy:\n\ndescription clearly states when the skill should be used\nAll \"when to use\" information is in description, not body" }, { "title": "Common Issues Found", "body": "Missing Functional Verification:\n\nSkill generates templates but they don't match actual specifications\nExample: AGENTS.md template missing session startup requirements\n\nIncomplete Descriptions:\n\nDescription doesn't include \"when to use\" information\nBody contains \"When to Use This Skill\" sections (should be in description)\n\nDuplication:\n\nSame information in both SKILL.md and references\nWastes context window tokens\n\nExtraneous Files:\n\nREADME.md, CHANGELOG.md, etc. in skill directory\nShould only contain SKILL.md and necessary resources\n\nPoor Progressive Disclosure:\n\nSKILL.md too verbose\nReferences not properly linked or described" }, { "title": "Review Checklist", "body": "For each skill, verify:\n\nLevel 1: Format validation passes\n Level 2: SKILL.md structure and quality are good\n Level 3: Generated templates match OpenClaw specifications\n Level 4: Best practices are followed\n No extraneous files\n Description includes \"when to use\" information\n References are properly linked from SKILL.md\n Scripts work correctly (if present)" }, { "title": "scripts/", "body": "review_skill.py - Automated review script (optional enhancement)" }, { "title": "references/", "body": "openclaw-specs.md - OpenClaw specifications for comparison\nbest-practices.md - Skill design best practices" } ], "body": "Skill Reviewer\n\nComprehensive skill review and validation for OpenClaw skills.\n\nOverview\n\nThis skill provides a systematic three-level review process to ensure skills are:\n\nValid - Proper structure and format\nComplete - All required components present\nCorrect - Generated outputs match OpenClaw specifications\nHigh-quality - Follows best practices\nReview Workflow\nLevel 1: Format Validation\n\nRun automatic validation using package_skill.py:\n\npython3 /home/yupeng/.npm-global/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py \n\n\nChecks:\n\nYAML frontmatter format and required fields\nSkill naming conventions and directory structure\nDescription completeness and quality\nFile organization and resource references\n\nOutcome: ✅ Valid or ❌ Validation errors\n\nLevel 2: Content Quality Assessment\n\nManually review SKILL.md for:\n\nFrontmatter:\n\nname is concise and follows naming conventions\ndescription is comprehensive and includes \"when to use\" information\nNo extraneous fields in YAML\n\nBody Structure:\n\nClear organization (workflow-based, task-based, or reference-based)\nProgressive disclosure pattern (metadata → SKILL.md → references)\nConcise and focused content\nImperative/infinitive form for instructions\n\nWriting Quality:\n\nNo filler or redundant explanations\nConcrete examples and realistic scenarios\nClear guidance on when to read reference files\nAvoids duplication between SKILL.md and references\nLevel 3: Functional Verification\n\nCritical Step - Verify that generated outputs match actual OpenClaw specifications.\n\nFor skills that generate templates:\n\nCompare generated templates with actual OpenClaw specification files\nExample: If skill generates AGENTS.md templates, compare with /home/yupeng/.openclaw/workspace/AGENTS.md\nCheck for missing required sections (session startup, memory workflow, safety rules, group chat etiquette, heartbeat mechanism)\nVerify all critical requirements are present\n\nFor skills with scripts:\n\nTest scripts to ensure they work correctly\nVerify output matches expected format\nCheck error handling\n\nFor skills with references:\n\nVerify reference files are accurate and up-to-date\nCheck that references are properly linked from SKILL.md\nLevel 4: Best Practices Check\n\nVerify the skill follows OpenClaw skill best practices:\n\nProgressive Disclosure:\n\nSKILL.md body is concise (<500 lines preferred)\nDetailed information moved to references/\nReferences are properly linked and described\n\nResource Organization:\n\nOnly necessary resource directories created\nNo extraneous files (README.md, INSTALLATION_GUIDE.md, etc.)\nScripts/ references/ assets/ used appropriately\n\nContext Efficiency:\n\nInformation lives in either SKILL.md OR references, not both\nEssential procedural instructions in SKILL.md\nDetailed reference material in references/\n\nTriggering Accuracy:\n\ndescription clearly states when the skill should be used\nAll \"when to use\" information is in description, not body\nCommon Issues Found\n\nMissing Functional Verification:\n\nSkill generates templates but they don't match actual specifications\nExample: AGENTS.md template missing session startup requirements\n\nIncomplete Descriptions:\n\nDescription doesn't include \"when to use\" information\nBody contains \"When to Use This Skill\" sections (should be in description)\n\nDuplication:\n\nSame information in both SKILL.md and references\nWastes context window tokens\n\nExtraneous Files:\n\nREADME.md, CHANGELOG.md, etc. in skill directory\nShould only contain SKILL.md and necessary resources\n\nPoor Progressive Disclosure:\n\nSKILL.md too verbose\nReferences not properly linked or described\nReview Checklist\n\nFor each skill, verify:\n\n Level 1: Format validation passes\n Level 2: SKILL.md structure and quality are good\n Level 3: Generated templates match OpenClaw specifications\n Level 4: Best practices are followed\n No extraneous files\n Description includes \"when to use\" information\n References are properly linked from SKILL.md\n Scripts work correctly (if present)\nResources\nscripts/\nreview_skill.py - Automated review script (optional enhancement)\nreferences/\nopenclaw-specs.md - OpenClaw specifications for comparison\nbest-practices.md - Skill design best practices" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/YKaiXu/openclaw-skill-reviewer", "publisherUrl": "https://clawhub.ai/YKaiXu/openclaw-skill-reviewer", "owner": "YKaiXu", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/openclaw-skill-reviewer", "downloadUrl": "https://openagent3.xyz/downloads/openclaw-skill-reviewer", "agentUrl": "https://openagent3.xyz/skills/openclaw-skill-reviewer/agent", "manifestUrl": "https://openagent3.xyz/skills/openclaw-skill-reviewer/agent.json", "briefUrl": "https://openagent3.xyz/skills/openclaw-skill-reviewer/agent.md" } }