Abner-MachadoAbner-Machado/agent-layer/rag-expiration-engine/SKILL.md

rag-expiration-engine

Skill2 starsChanged 57 days agoMITView on GitHub

Use quando uma base RAG precisa de validade temporal por documento, quando o agente responde com informacao desatualizada, ou quando voce quer marcar documentos com data de expiracao. Nao use para indexacao vetorial, embedding, busca semantica ou geracao de texto.

In this repository6 other files it gives its agents.
- agent-honeypot-detectorSkill
- agent-receiptSkill
- agent-trust-passportSkill
- ai-provenance-chainSkill
- rag-poison-ledgerSkill
- skill-poison-detectorSkill

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
Use apenas os arquivos validos no prompt
line 63

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

rag-expiration-engine

Validade temporal por documento em bases RAG. Fatos e instrucoes envelhecem — esta skill permite marcar quando cada documento vence e filtrar automaticamente os invalidos antes de injetar no contexto do agente.

Comandos

stamp — adicionar validade a um documento

node cli.mjs stamp <arquivo> <ttl> [--type <tipo>]

<arquivo>: caminho do documento
<ttl>: 30d, 6m, 1y, 2026-12-31, ou never
--type: opcional, aplica politica padrao de TTL

Grava metadado em .rag-expiration-index.json ao lado do documento. Nunca altera o arquivo original.

check — listar status de todos os documentos

node cli.mjs check --directory <dir>

Mostra: expirados, vencendo em <=30 dias, validos, sem validade definida.

filter — retornar apenas documentos validos

node cli.mjs filter <arquivo1> [arquivo2...] --date <data> --directory <dir>

Devolve so os documentos validos na data de referencia. O agente injeta apenas esses no contexto.

Tipos de conteudo e politica padrao

Tipo	TTL padrao	Exemplo
preco	30d	precos de API
versao / versao de software	6m	changelog
definicao / definicao conceitual	nunca	conceitos estaveis
tutorial	1y	guias
nota de release	6m	releases
contato	1y	emails
politica	1y	politicas

Uso pelo agente

Antes de injetar contexto RAG, rode node cli.mjs filter com a data atual
Use apenas os arquivos validos no prompt
Periodicamente rode check para auditar a base

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free