Skip to content
Back to skills

Rag Poison Ledger

ASecurity

Use quando um agente responde errado por causa de um documento RAG duvidoso e voce precisa rastrear QUAL documento causou o erro e quais respostas ja foram contaminadas. Nao use para audit geral de logs ou para armazenar historico completo de conversas.

  • 3 stars
  • 0 votes
  • 0 copies
  • 2 views
  • Added September 19, 2026
ai-agentsbashnode

Works with

  • cli

Security analysis

A100/100

Pro scans all 8 files and shows the line behind each finding

Scanned September 19, 2026

npx -y skills add Abner-Machado/agent-layer --skill rag-poison-ledger --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Rag Poison Ledger?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Rag Poison Ledger
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/abner-machado-rag-poison-ledger/badge)](https://www.skillsdirectory.com/skills/abner-machado-rag-poison-ledger)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: rag-poison-ledger
description: >-
  Use quando um agente responde errado por causa de um documento RAG duvidoso
  e voce precisa rastrear QUAL documento causou o erro e quais respostas ja
  foram contaminadas. Nao use para audit geral de logs ou para armazenar
  historico completo de conversas.
---

# rag-poison-ledger

Livro-razao append-only que liga documentos RAG a respostas de agentes.

## Problema

Quando um agente responde com base em documento incorreto na base RAG, nao
ha como saber: (1) qual documento causou o erro, (2) quais respostas
anteriores foram contaminadas pelo mesmo documento.

## Solucao

Um ledger JSONL com 4 comandos:

- **record** — registra uma resposta junto com os ids dos documentos que
  foram injetados no contexto dela
- **flag** — marca um documento como `poisoned` ou `incorrect`, informando
  quem marcou e por que
- **blast** — recebe o id de um documento marcado e devolve TODAS as
  respostas que usaram aquele documento, ordenadas da mais recente para
  a mais antiga
- **trace** — faz o caminho inverso: recebe o id de uma resposta e mostra
  todos os documentos que a alimentaram, com o status de cada um

## Uso

```bash
# Registrar uma resposta
node cli.mjs record ledger.jsonl resp-42 doc-a,doc-b --text "Resposta do agente"

# Marcar documento como envenenado
node cli.mjs flag ledger.jsonl doc-a poisoned alice --why "Contem dados desatualizados"

# Ver todas as respostas afetadas por doc-a
node cli.mjs blast ledger.jsonl doc-a

# Ver quais documentos alimentaram resp-42
node cli.mjs trace ledger.jsonl resp-42

# Consultar status de um documento
node cli.mjs status ledger.jsonl doc-a
```

## Armazenamento

Arquivo JSONL append-only. Linhas antigas nunca sao reescritas.
Correcoes entram como linhas novas (`type: correction`).
O status atual de um documento e derivado de flags + corrections.

## Dependencias

Nenhuma. Apenas Node.js 20+ (usa `node:fs`, `node:path`, `node:test`).

Files in this skill

  • PROVENANCE.md1.5 KB
  • README.md825 B
  • SKILL.md1.9 KB
  • cli.mjs7.9 KB
  • exemplos/exemplo.jsonl528 B
  • lib.mjs4.6 KB
  • package.json249 B
  • test.mjs9.9 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.