working-with-lacquer

Diagnose and resolve Lacquer drift, audit failures, and manifest configuration across managed projects.

3|Updated Jun 15, 2026
One-click install
npx skills add https://github.com/patrickserrano/lacquer --skill working-with-lacquer-patrickserrano
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: working-with-lacquer
Source: https://github.com/patrickserrano/lacquer/tree/main/core/skills/working-with-lacquer
Command: npx skills add https://github.com/patrickserrano/lacquer --skill working-with-lacquer-patrickserrano

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Projects managed by Lacquer can drift from the shared standard when managed files are edited locally, stacks go undeclared, or baselines are unmet, and this Skill explains how to interpret each audit exit code and apply the correct fix instead of silently diverging. ## Core Features & Use Cases - Exit-code-driven fixes: Maps lacquer audit exit codes 3, 4, 5, and 6 to concrete remediation recipes covering local edits, baseline violations, broken checks, and undeclared stacks. - Manifest configuration guidance: Explains [project].exclude, [baseline.relax], dependabot_ignore, and [project].retired entries with required fields, expiry semantics, and when to choose each opt-out. - Fleet-wide auditing: Covers lacquer fleet roster sweeps that surface expiring exemptions and paths excluded by multiple projects across every repo you own. - Use Case: CI fails with a "No lacquer drift" error after someone edited .swiftlint.yml locally; use this Skill to decide whether to upstream the change, exclude the file with a reason, or re-sync from the lacquer. ## Quick Start Ask the assistant to diagnose the current lacquer audit failure in this project and recommend the correct fix for the reported exit code.

Frequently Asked Questions about working-with-lacquer

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

FAQPage Schema
How do I fix a lacquer audit exit code 3 error?▼

Exit 3 means a lacquer-managed file was edited locally and sync would clobber it. Either upstream the change to the lacquer repo, add the file to `[project].exclude` with a reason if the project owns it, or run `lacquer sync --force` to take the lacquer's version.

What does lacquer audit exit code 6 mean?▼

Exit 6 means the project runs a stack that `.lacquer.toml` does not declare, leaving that toolchain with no hooks, CI, or CLAUDE region. Run `lacquer adopt` to record the stack additively, then `lacquer sync`, or exclude the path if it is deliberately unmanaged.

How do I exclude a file from lacquer management?▼

Add the path to `[project].exclude` in `.lacquer.toml` with a required `reason` field, plus an `until` date if the exclusion is temporary. An expired `until` becomes a hard audit failure with exit 4, and exclusions matching nothing the lacquer ships are flagged as stale.

When should I use retired instead of exclude in lacquer?▼

Use `exclude` when one project genuinely owns a single managed file. Use `[project].retired` with `since` and `reason` when the whole project is over: it stops scheduled workflows and Dependabot while keeping PR CI, lint configs, and hooks syncing so the repo still audits clean.

How do I audit all my lacquer projects at once?▼

Create a roster TOML file listing each project's name and path, then run `lacquer fleet --roster fleet.toml` for a summary or add `--json` for a diffable snapshot. It exits 4 if any project would fail its own audit and highlights expiring exemptions and multiply-excluded paths.

Why does lacquer audit keep failing on an expired baseline relaxation?▼

A `[baseline.relax]` entry requires both `until` and `reason`, and an expired entry is a hard failure with exit 4 by design. Either meet the baseline standard or update the entry with a new justified date rather than removing the expiry, which would redefine the standard.