agent-skills-not-found

Referenced skill does not exist in .claude/skills directory

pdugan20@pdugan20

GitHub

From plugin

claudelint

1113 skills13 agents1 command1 hook

Install

$ npx -y skills add pdugan20/claudelint --agent claude-code

How it fires

How this agent gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.

Context preview

The summary Claude sees to decide when to auto-load this agent.

Referenced skill does not exist in .claude/skills directory

Agent definition

agent-skills-not-found.md

description: "Referenced skill does not exist in .claude/skills directory"

agent-skills-not-found

Rule Details

This rule checks that every skill name listed in the `skills` array of agent frontmatter has a corresponding SKILL.md file at `.claude/skills/{skill-name}/SKILL.md`. Referencing a nonexistent skill causes the agent to fail when it tries to load or invoke the skill at runtime. The rule resolves the project root from the agent file path and checks each referenced skill directory.

Incorrect

Agent references a skill that does not exist

---
name: deploy-agent
description: Handles deployment pipelines
skills:
  - nonexistent-skill
---

Correct

Agent references skills that exist at .claude/skills/

---
name: deploy-agent
description: Handles deployment pipelines
skills:
  - run-tests
  - deploy
---

How To Fix

Create the missing skill directory and SKILL.md file at `.claude/skills/{skill-name}/SKILL.md`, or remove the nonexistent skill name from the `skills` array.

Options

This rule does not have any configuration options.

Related Rules

[`agent-skills`](/rules/agents/agent-skills)

Resources

[Rule Implementation](https://github.com/pdugan20/claudelint/blob/main/src/rules/agents/agent-skills-not-found.ts)
[Rule Tests](https://github.com/pdugan20/claudelint/blob/main/tests/rules/agents/agent-skills-not-found.test.ts)