archive

Archive blueprint artifacts into archive directories with content stored in git notes.

1|1|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/luan/agents --skill archive-luan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archive
Source: https://github.com/luan/agents/tree/main/skills/archive
Command: npx skills add https://github.com/luan/agents --skill archive-luan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires vlt.

What problem does it solve?

This Skill helps you move consumed blueprint artifacts out of active storage while preserving their full content for long-term retrieval.

Core Features & Use Cases

  • Artifact discovery and selection: Lists active artifacts across research, plan, and doc types, then lets you pick what to archive.
  • Slug- or path-based archival: Finds matching artifacts by slug/path substring and archives automatically when the match is unique (otherwise prompts for selection).
  • Git notes preservation: Stores the archived artifact content in git notes while moving it under the archive/ directory.

Quick Start

Ask the skill to archive a specific blueprint by slug so its content is preserved in git notes and moved into the archive folder.

Frequently Asked Questions about archive

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I archive blueprint artifacts without losing history?

Archiving blueprint artifacts without losing history involves moving implemented or obsolete files into an archive directory while preserving their full content in git notes for long-term retrieval.

How does preserving artifact content in git notes work?

Preserving artifact content in git notes works by moving the matching files out of active storage and storing their original content within git notes using the vlt archival workflow.

Can I archive specific blueprint artifacts by slug or path?

Yes, you can archive specific blueprint artifacts by matching a slug or path substring. If the match is unique, the archival happens automatically; otherwise, you will be prompted to select the correct target.

Do I need the vlt package to manage artifact lifecycles?

Yes, you need the vlt package to manage artifact lifecycles, as the archival workflow relies on it to record artifact contents and move consumed files into git notes.

What is the best way to retire obsolete research and doc artifacts?

The best way to retire obsolete research and doc artifacts is to list active artifacts, select the obsolete targets, and archive them to move files out of active storage while retaining historical context in git notes.

When should I not use the archive directory for blueprint artifacts?

You should not use the archive directory for blueprint artifacts when files are still actively needed in your CLI workflow, as archiving moves them out of active storage and into long-term preservation.