unknown-tool-skill

Validate skill configurations against known Claude Code tools.

376|31|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/avifenesh/agnix --skill unknown-tool-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unknown-tool-skill
Source: https://github.com/avifenesh/agnix/tree/main/tests/fixtures/invalid/skills/unknown-tool
Command: npx skills add https://github.com/avifenesh/agnix --skill unknown-tool-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Tools in skill configurations can reference unknown or unsupported tools, leading to misconfigurations that cause failures during skill activation. This skill detects such issues and guides users toward known Claude Code tools.

Core Features & Use Cases

  • Detects references to unknown tools in SKILL.md frontmatter and related configuration files.
  • Suggests valid tool options and remediation steps for common skill definitions.
  • Use Case: When a skill references a non-existent tool, this skill flags the issue and suggests replacing it with a known Claude Code tool like Bash, Read, or Write.

Quick Start

Review the SKILL.md frontmatter and replace any unknown tool names with a valid Claude Code tool.

Frequently Asked Questions about unknown-tool-skill

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

FAQPage Schema
How do I validate tool references in SKILL.md frontmatter config files?

To validate tool references in SKILL.md frontmatter config files, check them against a strict list of allowed Claude Code tools, flag any unknown tool names, and replace them with valid options to prevent activation failures.

Why does my skill configuration fail during activation due to unknown tools?

Skill configuration activation fails when frontmatter references unknown or unsupported tools, causing misconfigurations. Identifying these invalid tool references and replacing them with known Claude Code tools resolves the activation errors.

What are the allowed Claude Code tools for skill configurations?

Allowed Claude Code tools for skill configurations include Bash, Read, and Write. Enforcing this strict list prevents invalid tool references and ensures successful skill activation without configuration failures.

How do I fix invalid tool references in skill config files?

To fix invalid tool references in skill config files, review the SKILL.md frontmatter, identify any unknown tool names flagged by validation, and replace them with known Claude Code tools like Bash, Read, or Write.

Can I use custom tools in SKILL.md frontmatter configurations?

SKILL.md frontmatter configurations enforce a strict list of allowed Claude Code tools and do not support custom or unknown tool references, which are flagged as violations to prevent misconfigurations and activation failures.