OTSkit.ts
← Paquetes·latest

@otskit/skills

Preservation workflows for AI agents. Convierte "preserve this" en un paquete BagIt verificable: archivo o carpeta → ZIP sellado → hash del ZIP → OpenTimestamps → cuatro archivos portables.

Agent skillBagIt RFC 8493OAIS + PREMISOpenTimestampsMIT
Agente AI creando un paquete de preservación BagIt con OTSkit Skills

El problema

MCP da herramientas. Skills da una receta.

Un agente con acceso a stamp_file sabe sellar. Pero no sabe qué sellar, en qué orden, qué archivos crear ni qué no decirle al usuario.

Skills evita que el agente selle el archivo equivocado, olvide el .ots, ponga el hash dentro del ZIP o prometa cosas legales que no debe. Es el workflow completo, no solo la herramienta.

@otskit/mcp

Gives agents tools. hash_file, stamp_file, verify_timestamp…

@otskit/skills

Gives agents a preservation workflow. Cuándo usarlas, en qué orden, qué archivos crear.

Cómo se usa

Lenguaje natural

El agente detecta la intención y ejecuta el workflow completo. No hay que saber BagIt ni OpenTimestamps.

claude-codechat
preserve this folder
stamp this document
create a preservation package for this file
archive this: contract.pdf
preserve the /legal folder
claude@claude-code$ preserve this: contract.pdf
BagIt package created
ZIP sealed and hashed
Stamped via OpenTimestamps — pending
→ preserved-contract-2026-06-15.zip
→ preserved-contract-2026-06-15.sha256
→ preserved-contract-2026-06-15.ots
→ preserved-contract-2026-06-15.stamp-id.txt

Workflow

Qué ocurre por dentro

Copia la fuenteEstructura BagItMetadatos PREMIS/OAISCierra el ZIPHashea el ZIPSella con MCPEscribe los sidecars
Copia la fuente
Copia el archivo o carpeta tal cual. Sin modificar el original.
Estructura BagIt
Crea bag/ con data/ y los tagfiles según RFC 8493.
Metadatos PREMIS/OAIS
Genera premis.xml (objeto, evento, agente) y bag-info.txt (Bagging-Date, Source-Organization).
Cierra el ZIP
Comprime todo en un ZIP limpio.
Hashea el ZIP
SHA-256 del ZIP final — este hash es el que se sella, no archivos internos.
Sella con MCP
Llama a stamp_file o create_timestamp vía @otskit/mcp. Devuelve un id local.
Escribe los sidecars
Genera .sha256, .ots (pending) y .stamp-id.txt junto al ZIP.

Qué obtienes

Cuatro archivos siempre

El workflow produce exactamente cuatro archivos. Todos tienen el mismo prefijo y fecha. Juntos son el paquete completo.

preserved-<name>-<date>.zip

Paquete BagIt completo. Autónomo — incluye estructura data/, manifests, metadatos PREMIS/OAIS y la prueba .ots.

preserved-<name>-<date>.sha256

Hash SHA-256 del ZIP final. No checksums internos — el hash exacto que se selló con OpenTimestamps.

preserved-<name>-<date>.ots

Prueba OpenTimestamps vinculada al hash del ZIP. Verificable offline sin OTSkit.

preserved-<name>-<date>.stamp-id.txt

ID local para hacer upgrade/verify más tarde con @otskit/mcp. Guárdalo junto al .zip.

El .sha256 es el hash del ZIP final — el mismo hash que está sellado en el .ots. No son checksums de los archivos internos del BagIt.

Estándares

Estándares de preservación

El paquete que genera Skills es reconocible por archivos, bibliotecas y cualquier sistema de preservación digital que use estos estándares.

BagIt RFC 8493 — Empaquetado

Estructura bag/data/, manifests SHA-256, tagfiles. Formato reconocido por archivos y bibliotecas.

OAIS ISO 14721 — Preservación

Modelo SIP → AIP → DIP. bag-info.txt con metadatos de procedencia y organización.

PREMIS 3.0 — Procedencia

premis.xml con objeto, evento de creación, agente OTSkit. Auditable por terceros.

OpenTimestamps — Anclaje temporal

Prueba criptográfica en Bitcoin. El .ots se puede verificar offline con cualquier cliente OTS.

Garantías

Qué garantiza — y qué no

Skills codifica las reglas que un agente no debería tener que deducir solo.

Se sella el ZIP final, no el archivo original suelto.
El .ots vive junto al ZIP, nunca dentro.
Los archivos bajo data/ no se modifican.
Pending no es fallo — es el estado normal tras stamp.
La prueba acredita existencia, no autoría.
No se dice «notarizado» ni «certificado legal».
No se sella antes de cerrar el ZIP.
No se pone el .ots dentro del ZIP que se está sellando.

Instalación

Instalación

Vía Smithery

$ npx -y skills add https://smithery.ai/skills/otskit/preserve

Vía Claude Code plugin marketplace

$ /plugin marketplace add OTSkit/OTSkit-skills
$ /plugin install preserve@otskit-skills

Requisitos

@otskit/mcp configurado en el agente (Claude Desktop, Claude Code o Codex)
PowerShell en Windows o bash en Linux/macOS
El agente necesita acceso al archivo o carpeta local

Siguiente paso

Para usar Skills necesitas @otskit/mcp configurado en tu agente.