artifacts-registry

Registers and manages large, generated, or encrypted artifacts via Git LFS and age.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/toderian/project_template --skill artifacts-registry-toderian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: artifacts-registry
Source: https://github.com/toderian/project_template/tree/main/plugins/agents-tasks/skills/artifacts-registry
Command: npx skills add https://github.com/toderian/project_template --skill artifacts-registry-toderian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, generated, or encrypted files do not belong in plain Git history, yet teams still need a single place to discover where those artifacts live, how to fetch them, and how to verify them. This Skill defines a central registry in artifacts/README.md so nothing is tracked ad hoc and no plaintext secrets leak into the repository. ## Core Features & Use Cases - Central Registry: Every artifact or artifact group gets a row in artifacts/README.md with backend, path, encryption status, fetch command, and verify command. - Git LFS Workflow: Standardized commands for tracking narrow per-artifact patterns, pulling specific paths, and checking registry drift with git lfs ls-files. - Encrypted Artifacts: Conventions for age-encrypted files, with private keys kept under .creds/lfs/ and decrypted outputs under ignored .local/artifacts/ paths. - Use Case: When adding a 2 GB sample dataset to a repo, you track it with Git LFS under artifacts/lfs/sample-dataset-v1/, add a registry row with fetch and checksum commands, and commit the pointer files and .gitattributes update together. ## Quick Start Ask the agent to register a new large file as a Git LFS artifact and update the artifacts registry with its fetch and verify commands.

Frequently Asked Questions about artifacts-registry

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

FAQPage Schema
How do I add a large file to a Git repository with Git LFS?

Place the file under artifacts/lfs/<artifact-slug>/, run git lfs track with the narrowest matching pattern, and commit the .gitattributes update together with the pointer files. Then add a registry row in artifacts/README.md documenting fetch and verify commands.

How do I fetch only one specific Git LFS artifact?

Run git lfs pull --include="<path-or-pattern>" using the exact path listed in the registry row, after a one-time git lfs install per machine. Follow it with the registry's verify command, such as sha256sum --check on the artifact's checksum file.

How do I encrypt files in Git with age?

Encrypt the plaintext with age --encrypt and a recipient file, committing only the resulting .age file through Git LFS. Keep private keys under .creds/lfs/<artifact-slug>.agekey and decrypted outputs under ignored .local/artifacts/ paths, never in the repo.

How do I check for drift between Git LFS files and the registry?

Run git lfs ls-files --name-only and confirm every tracked path has a corresponding row in artifacts/README.md. Any LFS-tracked path missing from the registry indicates drift that must be fixed in the same change as the artifact.

When should I not use broad Git LFS patterns like *.zip?

Avoid broad repository-wide patterns unless every matching file belongs to one intentional artifact group documented in the registry. The quality bar requires narrow, per-artifact .gitattributes rules so unrelated files are never silently pulled into LFS.