Top AI Repos — open-source AI, indexed and scored
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Provider-neutral Agent Skill for Codex, Claude Code, and agentic harness design.
| Date | Stars |
|---|---|
| 2026-07-24 | 2153 |
| 2026-07-25 | 2154 |
| 2026-07-28 | 2154 |
| 2026-07-30 | 2154 |
| 2026-07-31 | 2171 |
| 2026-08-06 | 2171 |
Today
— stars today
This week
+17 stars this week
This month
— stars this month
Momentum
4.1
growth rate 0.79%/day
<div align="center">
# agents-best-practices
<img src="icon.jpeg" alt="agents-best-practices icon" width="300" />
> *"The model proposes actions; the harness validates, authorizes, executes, records, and returns observations."*
[](LICENSE)
[](SKILL.md)
[](SKILL.md)
[](SKILL.md)
<br>
**A provider-neutral Agent Skill for designing, generating MVP blueprints for, auditing, refactoring, and explaining agentic harnesses.**
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.
<br>
**Install** - pick one:
</div>
**A. With [`skills`](https://github.com/vercel-labs/skills) (any compatible agent):**
```bash
npx skills add DenisSergeevitch/agents-best-practices -g
```
The `-g` flag installs globally at user level so every project can discover it.
**B. Or paste this prompt to your AI agent:**
```text
Install the agents-best-practices skill for me:
1. Clone https://github.com/DenisSergeevitch/agents-best-practices into my
user-level skills directory as `agents-best-practices/`.
Use the skill directory my agent reads on this machine, for example:
- Codex: ~/.codex/skills/
- Claude Code: ~/.claude/skills/
2. Verify that SKILL.md, icon.jpeg, and the references/ directory are present.
3. Confirm the install path when done.
```
**C. Manual install paths:**
```bash
# Codex
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
git clone https://github.com/DenisSergeevitch/agents-best-practices.git \
"${CODEX_HOME:-$HOME/.codex}/skills/agents-best-practices"
# Claude Code, user-level
mkdir -p "$HOME/.claude/skills"
git clone https://github.com/DenisSergeevitch/agents-best-practices.git \
"$HOME/.claude/skills/agents-best-practices"
# Claude Code, project-level
mkdir -p .claude/skills
git clone https://github.com/DenisSergeevitch/agents-best-practices.git \
.claude/skills/agents-best-practices
```
<div align="center">
[Use cases](#use-cases) · [What this is](#what-this-is) · [Philosophy](#philosophy) · [Layout](#layout) · [Sources](#sources)
</div>
---
## Use cases
<p align="center">
<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" />
</p>
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:
### Case 1 - Generate an MVP agent blueprint
You have a domain and need the smallest useful production-safe agent harness, not a vague list of best practices.
```text
You > Build an agent for account renewal risk. It should read CRM,
support tickets, and usage data, then draft renewal actions.
Agent > Start with an approval-gated Level 2 harness.
The MVP has one job: produce a renewal-risk brief plus draft
next actions for a human account owner.
Core loop:
user/task -> context builder -> model call -> typed tool call
-> schema validation -> permission check -> execution or pause
-> structured observation -> next step or final brief
Minimal tools:
- read_account_profile read_private_data
- list_support_tickets read_private_data
- fetch_usage_summary read_private_data
- draft_customer_email draft_external_message
- request_approval approval_gate
LExcerpt of 13,451 characters
Read on GitHub
10
Would you bet a product on this? Bounded 0–100 and slow moving.
matched fp:6abe3d6e2abfced5, topic:ai-agents, topic:agents, readme:ai agent