Skip to content
Back to skills

Rag Expiration Engine

ASecurity

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.

  • 3 stars
  • 0 votes
  • 0 copies
  • 1 view
  • Added September 19, 2026
ai-agentsbashnodeapi

Works with

  • cli
  • api

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-expiration-engine --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Rag Expiration Engine?

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

Security grade badge for Rag Expiration Engine
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/abner-machado-rag-expiration-engine/badge)](https://www.skillsdirectory.com/skills/abner-machado-rag-expiration-engine)

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-expiration-engine
description: >-
  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.
---

# 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

```bash
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

```bash
node cli.mjs check --directory <dir>
```

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

### filter — retornar apenas documentos validos

```bash
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

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

Files in this skill

  • PROVENANCE.md1.4 KB
  • README.md1007 B
  • SKILL.md1.9 KB
  • cli.mjs6.5 KB
  • exemplos/precos-api.md212 B
  • lib.mjs4.1 KB
  • package.json292 B
  • test.mjs3.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.