agent-assets

Audit committed agent commands, workflows, vendored docs, and tool configuration for gaps and staleness.

1|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/arndvs/ctrlshft --skill agent-assets-arndvs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-assets
Source: https://github.com/arndvs/ctrlshft/tree/main/skills/agent-assets
Command: npx skills add https://github.com/arndvs/ctrlshft --skill agent-assets-arndvs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Agent infrastructure — reusable commands, autonomous CI workflows, vendored documentation, MCP configuration, and orientation files like CLAUDE.md or AGENTS.md — accumulates without ownership, drifts out of sync with the code, and fails silently. This Skill audits that scaffolding and identifies what to add, consolidate, or retire. ## Core Features & Use Cases - Inventory and staleness detection: Locates .claude/commands/, AGENTS.md, vendored docs, agent CI workflows, and tool configuration, then checks whether each still describes the actual repository. - Gap analysis from repeated work: Finds multi-step sequences repeated in shell history, READMEs, and PR descriptions that should become committed commands (three occurrences make a pattern). - Silent failure detection: Flags autonomous workflows that swallow errors with || true, exit zero after failure branches, or produce no artifacts, making breakage invisible for months. - Use Case: A team notices their nightly agent review workflow has reported success for months but produced nothing. This Skill traces the silent failure, identifies stale orientation files contradicting the code, and proposes which repeated prompts should become committed slash commands. ## Quick Start Ask the agent to audit the repository's agent assets — review the .claude directory, AGENTS.md, and agent CI workflows — and report what is stale, missing, or silently failing.

Frequently Asked Questions about agent-assets

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

FAQPage Schema
How do I audit my .claude directory and AGENTS.md files?▼

Inventory every command, orientation file, vendored doc, and agent workflow, then open each one and check whether it still describes the current repository. Stale assets are worse than missing ones because they produce confident wrong work without anything failing.

When should a repeated prompt become a committed slash command?▼

Three occurrences make a pattern worth committing. A committed command is identical on every run, reviewable in a PR, and fixable in one place, while retyped prose drifts invisibly. Commit the literal text that worked and generalize only when a second use case appears.

Why do autonomous agent workflows fail silently in CI?▼

Silent failure usually comes from `|| true` on failing steps, caught exceptions that exit zero, or removed artifact uploads. The workflow reports success while producing nothing. Design so a run that did no work is distinguishable from a run that failed to do work.

Should I vendor external documentation into my repo for agents?▼

Vendor docs for libraries central to the codebase, especially after breaking changes, and for anything agents fetch repeatedly. Record the source URL, version, and fetch date on each file, since unversioned copies go stale invisibly and produce confidently wrong code.

When should I not build an autonomous agent workflow?▼

Skip autonomy when the task runs less than weekly or its output needs a human decision anyway — a committed command someone invokes is cheaper and fails visibly. Autonomy pays off only when work is repetitive, verification is automated, and a missed run costs little.