Add anti-hallucination skill#10
Open
victorfelisbino wants to merge 1 commit into
Open
Conversation
Adds vs-code-agents/skills/anti-hallucination/SKILL.md following the existing skill convention (YAML frontmatter, MIT, single SKILL.md per folder). The skill prevents the four most common hallucination shapes in coding agents: invented surface area, 'should work' without proof, admin-only proofs, and 'no issues found' without running a check. It also includes a per-agent-role usage table so Planner / Architect / Implementer / Critic / Code-Reviewer / Security / QA / UAT / DevOps each have a clear hook. A 5-prompt before/after test harness with a results template and a redacted example is maintained in the upstream repo (my-agent-memory) and linked from the skill. The skill is content-only; no scripts/.
victorfelisbino
added a commit
to victorfelisbino/my-agent-memory
that referenced
this pull request
May 26, 2026
- docs/roadmap.md: Wave 2 marked IN PROGRESS with done item linking to groupzer0/vs-code-agents#10 - docs/status.md: public probe moved into Real-today (PR open, awaiting review) and out of Planned - skills/general/anti-hallucination/results-examples/example-redacted.md: redacted before/after example so reviewers can see the expected harness shape without running it themselves The PR itself adds vs-code-agents/skills/anti-hallucination/SKILL.md upstream, matching their YAML + single-SKILL.md convention, with a per-agent usage table mapping Planner / Architect / Implementer / Critic / Code-Reviewer / Security / QA / UAT / DevOps each to the specific hallucination shape they should refuse. Co-authored-by: Victor Felisbino <victor.felisbino@provisionsgroup.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a new skill at
vs-code-agents/skills/anti-hallucination/SKILL.mdfollowing the existing single-fileSKILL.md+ YAML-frontmatter convention used by the other skills in this repo.What the skill does
It biases the agent toward evidence and explicit uncertainty by refusing the four most common hallucination shapes in coding agents:
It also defines a four-rung verification ladder (source → repro → diff → outcome) and an opinionated response-hygiene section.
Why I think it fits this repo
The existing agents in this repo (Planner, Architect, Implementer, Critic, Code-Reviewer, Security, QA, UAT, DevOps) all have moments where wrong-but-confident is more expensive than slow-but-right. The skill includes a per-agent usage table at the bottom mapping each agent to the specific shape it should refuse — so it's not a generic "be careful" doc, it has a concrete hook for each role you already ship.
It also slots cleanly next to
code-review-checklistandengineering-standards: those skills are about what to look for, this one is about what kind of answer the agent is allowed to send back.Evidence / test harness
A 5-prompt before/after test harness lives in the upstream repo where the skill originated: https://github.com/victorfelisbino/my-agent-memory/blob/main/skills/general/anti-hallucination/test-prompts.md. Each prompt baits one of the four shapes and ships with a binary pass/fail rule. Pass bar: ≥3/5 prompts pass with the skill loaded and fail without it. A results template and a redacted example results file are in the same folder so reviewers can see the expected before/after shape without running it themselves.
I have not yet run the harness in this repo's exact agent + model setup — that's a known gap I'm open about. If maintainers want a recorded run before merge, I can do one against
code-reviewer.agent.mdorsecurity.agent.mdand post results in this PR.Notes for reviewers
engineering-standardsandanalysis-methodology.upstream:link in the frontmatter pointing back to the source so updates can be tracked..agent.mdfile — agents have to explicitly load the skill, same as the rest of the skills directory.Happy to revise the framing, rename, restructure, or drop sections you find too prescriptive. If the right move is to start with an issue / discussion first instead of a PR, just say and I'll close this and convert.