agents-best-practices
starsforks
How to install agents-best-practices?
denissergeevitch/agents-best-practices
$git clone https://github.com/DenisSergeevitch/agents-best-practices> *"The model proposes actions; the harness validates, authorizes, executes, records, and returns observations."*
README.md
| 1 | <div align="center"> |
| 2 | |
| 3 | # agents-best-practices |
| 4 | |
| 5 | <img src="icon.jpeg" alt="agents-best-practices icon" width="300" /> |
| 6 | |
| 7 | > *"The model proposes actions; the harness validates, authorizes, executes, records, and returns observations."* |
| 8 | |
| 9 | [](LICENSE) |
| 10 | [](SKILL.md) |
| 11 | [](SKILL.md) |
| 12 | [](SKILL.md) |
| 13 | |
| 14 | <br> |
| 15 | |
| 16 | **A provider-neutral Agent Skill for designing, generating MVP blueprints for, auditing, refactoring, and explaining agentic harnesses.** |
| 17 | |
| 18 | It applies beyond coding agents: research, support, operations, sales, finance, data analysis, procurement, legal workflows, healthcare workflows, education, and workflow automation agents all need the same core runtime discipline. |
| 19 | |
| 20 | <br> |
| 21 | |
| 22 | **Install** - pick one: |
| 23 | |
| 24 | </div> |
| 25 | |
| 26 | **A. With [`skills`](https://github.com/vercel-labs/skills) (any compatible agent):** |
| 27 | |
| 28 | ```bash |
| 29 | npx skills add DenisSergeevitch/agents-best-practices -g |
| 30 | ``` |
| 31 | |
| 32 | The `-g` flag installs globally at user level so every project can discover it. |
| 33 | |
| 34 | **B. Or paste this prompt to your AI agent:** |
| 35 | |
| 36 | ```text |
| 37 | Install the agents-best-practices skill for me: |
| 38 | |
| 39 | 1. Clone https://github.com/DenisSergeevitch/agents-best-practices into my |
| 40 | user-level skills directory as `agents-best-practices/`. |
| 41 | Use the skill directory my agent reads on this machine, for example: |
| 42 | - Codex: ~/.codex/skills/ |
| 43 | - Claude Code: ~/.claude/skills/ |
| 44 | 2. Verify that SKILL.md, icon.jpeg, and the references/ directory are present. |
| 45 | 3. Confirm the install path when done. |
| 46 | ``` |
| 47 | |
| 48 | **C. Manual install paths:** |
| 49 | |
| 50 | ```bash |
| 51 | # Codex |
| 52 | mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills" |
| 53 | git clone https://github.com/DenisSergeevitch/agents-best-practices.git \ |
| 54 | "${CODEX_HOME:-$HOME/.codex}/skills/agents-best-practices" |
| 55 | |
| 56 | # Claude Code, user-level |
| 57 | mkdir -p "$HOME/.claude/skills" |
| 58 | git clone https://github.com/DenisSergeevitch/agents-best-practices.git \ |
| 59 | "$HOME/.claude/skills/agents-best-practices" |
| 60 | |
| 61 | # Claude Code, project-level |
| 62 | mkdir -p .claude/skills |
| 63 | git clone https://github.com/DenisSergeevitch/agents-best-practices.git \ |
| 64 | .claude/skills/agents-best-practices |
| 65 | ``` |
| 66 | |
| 67 | <div align="center"> |
| 68 | |
| 69 | [Use cases](#use-cases) · [What this is](#what-this-is) · [Philosophy](#philosophy) · [Layout](#layout) · [Sources](#sources) |
| 70 | |
| 71 | </div> |
| 72 | |
| 73 | --- |
| 74 | |
| 75 | ## Use cases |
| 76 | |
| 77 | <p align="center"> |
| 78 | <img src="assets/agents-best-practices-illustrations/01-use-cases.jpg" alt="Xiaohei sorting agent harness use cases into MVP blueprint, audit fixes, and permission map" width="760" /> |
| 79 | </p> |
| 80 | |
| 81 | Once installed, the skill activates when a conversation touches agent architecture, harness design, tool permissions, planning mode, workflow orchestration, context and memory, skills, connectors, observability, evals, prompt caching, or production readiness. Three common ways to use it: |
| 82 | |
| 83 | ### Case 1 - Generate an MVP agent blueprint |
| 84 | |
| 85 | You have a domain and need the smallest useful production-safe agent harness, not a vague list of best practices. |
| 86 | |
| 87 | ```text |
| 88 | You > Build an agent for account renewal risk. It should read CRM, |
| 89 | support tickets, and usage data, then draft renewal actions. |
| 90 | |
| 91 | Agent > Start with an approval-gated Level 2 harness. |
| 92 | The MVP has one job: produce a renewal-risk brief plus draft |
| 93 | next actions for a human account owner. |
| 94 | |
| 95 | Core loop: |
| 96 | user/task -> context builder -> model call -> typed tool call |
| 97 | -> schema validation -> permission check -> execution or pause |
| 98 | -> structured observation -> next step or final brief |
| 99 | |
| 100 | Minimal tools: |
| 101 | - read_account_profile read_private_data |
| 102 | - list_support_tickets read_private_data |
| 103 | - fetch_usage_summary read_private_data |
| 104 | - draft_customer_email draft_external_message |
| 105 | - request_approval approval_gate |
| 106 | |
| 107 | L |
People who liked this also viewed
6 picksType
- Figma-Context-MCPMCP server to provide Figma layout information to AI coding agents like CursorMCP ServersJul 2026
- sunnysideFigma-Context-MCPA comprehensive Model Context Protocol (MCP) server that bridges Figma designs with AI development workflows. It provides 30 specialized tools for extracting pixel-perfect code, assets, and component structures directly from Figma designs.MCP ServersApr 2026
- figma-console-mcpYour design system as an API. Connect AI to Figma for extraction, creation, and debugging.MCP ServersJul 2026
- dcc-mcp-coreCore runtime and shared tooling for DCC-MCP: safe, skill-first MCP integration across Maya, Blender, Houdini, Photoshop, and custom DCC hosts.MCP ServersJul 2026
- godot-aiProduction-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.MCP ServersJul 2026
- freecad-mcpFreeCAD MCP(Model Context Protocol) serverMCP ServersJul 2026
