modify-library

Mutate libraries.yaml entries for git and symlink libraries with validation.

63|8|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/JoranHonig/grimoire --skill modify-library
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: modify-library
Source: https://github.com/JoranHonig/grimoire/tree/main/skills/modify-library
Command: npx skills add https://github.com/JoranHonig/grimoire --skill modify-library

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps maintain the Grimoire librarian's library index by enabling the user to add, remove, or modify library entries in libraries.yaml, ensuring the librarian references accurate sources and prevents stale entries.

Core Features & Use Cases

  • Add, remove, or change library entries in libraries.yaml to reflect current sources and access patterns.
  • Validate that the libraries.yaml file exists and is valid YAML, verify the target entry's presence or absence for the operation, and validate the library source (git reachable or absolute path for symlink) before applying changes.
  • Optionally clone git libraries into the library/ directory upon addition, and provide clear reporting and error handling to rollback on failures.

Quick Start

Provide an operation (add, remove, or change), the library name, the type (git or symlink), and the source so I can update libraries.yaml accordingly.

Frequently Asked Questions about modify-library

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

FAQPage Schema
How do I add a git library to libraries.yaml?

Adding a git library to libraries.yaml requires providing the operation, name, type, and source. The Skill validates reachability, updates the YAML index, and optionally clones the repository into the library directory.

What is the best way to manage Grimoire library entries?

Managing Grimoire library entries involves automating mutations to libraries.yaml. The Skill adds, removes, or updates entries while validating YAML structure, entry existence, and source reachability before applying changes.

Can I use a symlink to add a local library to the index?

Yes, you can use a symlink to add a local library. The Skill validates that the symlink source is an absolute path before updating libraries.yaml to ensure the librarian references accurate local sources.

Does the librarian validate libraries.yaml before applying changes?

The librarian validates libraries.yaml before applying changes. It checks file existence, verifies valid YAML structure, confirms target entry presence or absence, and validates source reachability to prevent stale entries.

What happens when a library update fails in libraries.yaml?

When a library update fails in libraries.yaml, the Skill provides clear error reporting and performs a rollback. This prevents partial updates and ensures the index maintains accurate, functional library references.

When do I need to remove stale entries from libraries.yaml?

You need to remove stale entries from libraries.yaml when sources become unreachable or inaccurate. The Skill automates entry removal after validating the target entry's presence in the YAML index.