# Send Agent Guardrails to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "agent-guardrails", "name": "Agent Guardrails", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/olmmlo-cmd/agent-guardrails", "canonicalUrl": "https://clawhub.ai/olmmlo-cmd/agent-guardrails", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/agent-guardrails", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-guardrails", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "CHANGELOG.md", "CLAUDE_CODE_INSTALL.md", "GITHUB_TOPICS_GUIDE.md", "PUBLISHING.md", "PUBLISH_NOW.sh", "README.md" ], "downloadMode": "redirect", "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/agent-guardrails" }, "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." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/agent-guardrails", "downloadUrl": "https://openagent3.xyz/downloads/agent-guardrails", "agentUrl": "https://openagent3.xyz/skills/agent-guardrails/agent", "manifestUrl": "https://openagent3.xyz/skills/agent-guardrails/agent.json", "briefUrl": "https://openagent3.xyz/skills/agent-guardrails/agent.md" } } ``` ## Documentation ### Agent Guardrails Mechanical enforcement for AI agent project standards. Rules in markdown are suggestions. Code hooks are laws. ### Quick Start cd your-project/ bash /path/to/agent-guardrails/scripts/install.sh This installs the git pre-commit hook, creates a registry template, and copies check scripts into your project. ### Enforcement Hierarchy Code hooks (git pre-commit, pre/post-creation checks) — 100% reliable Architectural constraints (registries, import enforcement) — 95% reliable Self-verification loops (agent checks own work) — 80% reliable Prompt rules (AGENTS.md, system prompts) — 60-70% reliable Markdown rules — 40-50% reliable, degrades with context length ### Scripts ScriptWhen to RunWhat It Doesinstall.shOnce per projectInstalls hooks and scaffoldingpre-create-check.shBefore creating new .py filesLists existing modules/functions to prevent reimplementationpost-create-validate.shAfter creating/editing .py filesDetects duplicates, missing imports, bypass patternscheck-secrets.shBefore commits / on demandScans for hardcoded tokens, keys, passwordscreate-deployment-check.shWhen setting up deployment verificationCreates .deployment-check.sh, checklist, and git hook templateinstall-skill-feedback-loop.shWhen setting up skill update automationCreates detection, auto-commit, and git hook for skill updates ### Assets AssetPurposepre-commit-hookReady-to-install git hook blocking bypass patterns and secretsregistry-template.pyTemplate __init__.py for project module registries ### References FileContentsenforcement-research.mdResearch on why code > prompts for enforcementagents-md-template.mdTemplate AGENTS.md with mechanical enforcement rulesdeployment-verification-guide.mdFull guide on preventing deployment gapsskill-update-feedback.mdMeta-enforcement: automatic skill update feedback loopSKILL_CN.mdChinese translation of this document ### Setting up a new project bash scripts/install.sh /path/to/project ### Before creating any new .py file bash scripts/pre-create-check.sh /path/to/project Review the output. If existing functions cover your needs, import them. ### After creating/editing a .py file bash scripts/post-create-validate.sh /path/to/new_file.py Fix any warnings before proceeding. ### Setting up deployment verification bash scripts/create-deployment-check.sh /path/to/project This creates: .deployment-check.sh - Automated verification script DEPLOYMENT-CHECKLIST.md - Full deployment workflow .git-hooks/pre-commit-deployment - Git hook template Then customize: Add tests to .deployment-check.sh for your integration points Document your flow in DEPLOYMENT-CHECKLIST.md Install the git hook See references/deployment-verification-guide.md for full guide. ### Adding to AGENTS.md Copy the template from references/agents-md-template.md and adapt to your project. ### 中文文档 / Chinese Documentation See references/SKILL_CN.md for the full Chinese translation of this skill. ### 1. Reimplementation (Bypass Pattern) Symptom: Agent creates "quick version" instead of importing validated code. Enforcement: pre-create-check.sh + post-create-validate.sh + git hook ### 2. Hardcoded Secrets Symptom: Tokens/keys in code instead of env vars. Enforcement: check-secrets.sh + git hook ### 3. Deployment Gap Symptom: Built feature but forgot to wire it into production. Users don't receive benefit. Example: Updated notify.py but cron still calls old version. Enforcement: .deployment-check.sh + git hook This is the hardest to catch because: Code runs fine when tested manually Agent marks task "done" after writing code Problem only surfaces when user complains Solution: Mechanical end-to-end verification before allowing "done." ### 4. Skill Update Gap (META - NEW) Symptom: Built enforcement improvement in project but forgot to update the skill itself. Example: Created deployment verification for Project A, but other projects don't benefit because skill wasn't updated. Enforcement: install-skill-feedback-loop.sh → automatic detection + semi-automatic commit This is a meta-failure mode because: It's about enforcement improvements themselves Without fix: improvements stay siloed With fix: knowledge compounds automatically Solution: Automatic detection of enforcement improvements with task creation and semi-automatic commits. ### Key Principle Don't add more markdown rules. Add mechanical enforcement. If an agent keeps bypassing a standard, don't write a stronger rule — write a hook that blocks it. Corollary: If an agent keeps forgetting integration, don't remind it — make it mechanically verify before commit. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: olmmlo-cmd - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-23T16:43:11.935Z - Expires at: 2026-04-30T16:43:11.935Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/agent-guardrails) - [Send to Agent page](https://openagent3.xyz/skills/agent-guardrails/agent) - [JSON manifest](https://openagent3.xyz/skills/agent-guardrails/agent.json) - [Markdown brief](https://openagent3.xyz/skills/agent-guardrails/agent.md) - [Download page](https://openagent3.xyz/downloads/agent-guardrails)