artifacts

Generates a repo-local audit trail with plan, todo, and walkthrough files.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/hyophyop/artifacts-skill --skill artifacts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: artifacts
Source: https://github.com/hyophyop/artifacts-skill/tree/main/artifacts
Command: npx skills add https://github.com/hyophyop/artifacts-skill --skill artifacts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires chromadb, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables teams to create a durable, repo-local audit trail for task work by automatically generating a dedicated workspace under .artifacts/artifacts/{request_id} with plan.md, todo.md, and walkthrough.md, and indexing the completed work into a local ChromaDB store at .artifacts/chroma_db/ for 7-day recall.

Core Features & Use Cases

  • Confirm-before-execute workflow: generate plan and todo files, wait for user confirmation before implementing changes.
  • Artifact indexing & recall: store a detailed walkthrough and index completed work for quick future recall.
  • Repo-local data governance: all byproducts stay under .artifacts/ with TTL-based pruning to manage retention.

Quick Start

Run the artifacts init command to create a new artifacts workspace in your target repository.

Frequently Asked Questions about artifacts

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

FAQPage Schema
How do I create a repo-local audit trail for task work?

To create a repo-local audit trail for task work, this Skill generates a dedicated workspace under .artifacts/artifacts/{request_id} containing plan.md, todo.md, and walkthrough.md files, then indexes the results into a local ChromaDB store for 7-day recall.

How does indexing completed task work into ChromaDB enable Q&A?

Indexing completed task work into ChromaDB enables Q&A by storing detailed walkthroughs in a local vector database at .artifacts/chroma_db/, allowing you to query the artifacts index and retrieve past task results for up to 7 days.

Do I need a confirm-before-execute workflow for repo-local task tracking?

A confirm-before-execute workflow for repo-local task tracking generates plan and todo files first, then waits for your explicit confirmation before implementing any changes, ensuring you review the proposed work before it is applied.

What is the retention period for artifacts indexed in a local ChromaDB store?

The retention period for artifacts indexed in a local ChromaDB store is 7 days, managed by TTL-based pruning that automatically removes expired data to maintain repository-local data governance under the .artifacts/ directory.

Does the artifacts workspace support bootstrapping a Python environment automatically?

Yes, the artifacts workspace supports bootstrapping a Python environment automatically under .artifacts/, satisfying repository-local lifecycle requirements by initializing the necessary dependencies for ChromaDB indexing and TTL-based pruning.

What limitations exist when using repo-local artifacts for task work?

Limitations of repo-local artifacts include a strict 7-day TTL-based pruning window for ChromaDB recall, and all byproducts being confined to the .artifacts/ directory, meaning indexed data is not shared across different repositories.