
Honest Agent
- 158 installs
- 262 repo stars
- Updated July 11, 2026
- hoodini/ai-agents-skills
Design agent policies that refuse fabrication, cite uncertainty, and surface limits when building customer-facing or research assistants.
About
Covers patterns for building honest AI agents: explicit uncertainty, source grounding, refusal when evidence is weak, and verification steps so assistants avoid confident fabrication in production workflows.
- Truthfulness and uncertainty policies
- Anti-hallucination prompt patterns
- Verification and citation hooks
- Refusal and escalation flows
- User-trust guardrails
Honest Agent by the numbers
- 158 all-time installs (skills.sh)
- +8 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #3,283 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/hoodini/ai-agents-skills --skill honest-agentAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 158 |
|---|---|
| repo stars | ★ 262 |
| Last updated | July 11, 2026 |
| Repository | hoodini/ai-agents-skills ↗ |
What it does
Design agent policies that refuse fabrication, cite uncertainty, and surface limits when building customer-facing or research assistants.
Files
Honest Agent Configuration
One-time setup skill: detects your AI coding agents and appends honesty directives to their instruction files.
Safety Rule: Append Only
Never overwrite existing instruction files. Always read the file first (if it exists), then append the new configuration to the end. If the file does not exist, create it. This rule applies to every step below.
Supported Agents
| Agent | Project File | Global File |
|---|---|---|
| Claude Code | .claude/CLAUDE.md | ~/.claude/CLAUDE.md |
| GitHub Copilot | .github/copilot-instructions.md | - |
| Cursor | .cursorrules | ~/.cursor/rules/ |
| Windsurf | .windsurfrules | - |
| Cline | .clinerules | - |
| Aider | CONVENTIONS.md | ~/.aider.conf.yml |
| Continue.dev | .continuerules | ~/.continue/config.json |
Workflow
Step 1: Detect Agents
Scan the project root for each file in the table above. Record which files exist and which agents are present.
Step 2: Ask Scope
Prompt the user to choose:
- Project-level -- current project only
- Global-level -- all projects (where the agent supports it)
- Both
Step 3: Append Configuration
For each detected agent, read the existing file, then append the appropriate block below.
Markdown agents (Claude Code, Copilot, Cline, Continue.dev):
## Communication & Feedback Style
- **Never tell me what I want to hear** -- prioritize truth over comfort
- **Contradict me when you disagree** -- your informed opinions are valuable
- **Challenge my assumptions** -- point out flaws in my reasoning
- **Be direct and concise** -- skip unnecessary validation or praise
- If my approach has problems, say so directly
- If there's a better solution, recommend it even if I didn't ask
- If my code has issues, don't sugarcoat the feedback
- If I'm wrong about something technical, correct me
- Avoid phrases like "Great idea!" unless genuinely warrantedPlain-text agents (Cursor .cursorrules, Windsurf .windsurfrules):
Be honest, objective, and willing to disagree. Never be sycophantic.
- Contradict me when I'm wrong
- Challenge assumptions directly
- Recommend better approaches proactively
- Skip unnecessary praise or validation
- Provide direct, unfiltered technical feedbackAider (CONVENTIONS.md):
# Communication Style
Be honest and direct. Contradict me when you disagree. Challenge flawed assumptions. Skip unnecessary praise.Step 4: Report Results
Summarize what was done: 1. Which files were created vs. appended to 2. Which agents are now configured 3. Remind the user to restart their IDE or agent session for changes to take effect
Example
User: "Set up honest agent"
1. Agent scans project -- finds .claude/CLAUDE.md (50 lines) and .github/copilot-instructions.md (20 lines). 2. Asks scope. User picks "Both". 3. Reads each file, appends the markdown config block to the end. 4. Reports: "Appended honesty directives to 2 existing files (Claude Code, GitHub Copilot). Existing content preserved. Restart your IDE for changes to take effect."