[BUG] Skill in project folder are ignored, not usable

Status Fixed / completed
Maintainer reply None cached
Activity 5 comments · opened Oct 22, 2025 · closed Oct 23, 2025

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

When I ask Claude what skills it has, it searches for md files and tells me the skills that I can use as slash commands, then when I run those commands, it says it does not have those commands.

> what skills do you have?

● Based on this project's configuration, I have access to the following slash commands (defined in .claude/skills/):

  Available Commands

  1. /start-task - Initialize a phase task with dependency checking and todo list creation
  2. /update-progress - Log completed tasks to PROGRESS-LOG.md with consistent formatting
  3. **/flutter-test** - Run Flutter tests with project standards enforcement (enforces no print statements, informative failure messages,
  etc.)
  4. /db-migration - Database migration workflow with Alembic (handles guard variables, validation, and schema versioning)
  5. /validate-ci-sync - Verify CI/CD configuration alignment (ensures pre-commit hooks match GitHub Actions)
  6. /android-build-validate - Validate Android build configuration (checks desugar_jdk_libs version and settings)
  7. /project-code-review - Comprehensive project-level code review covering performance, errors, and security

  General Capabilities

  Beyond these project-specific commands, I can help you with:

  - Code implementation - Writing Flutter/Dart, Python/FastAPI, SQL
  - Testing - Creating and running tests with proper standards
  - Database work - Schema design, migrations, PostGIS queries
  - Git operations - Commits, branches, PRs
  - Documentation - Code comments, technical docs
  - Debugging - Analyzing logs, fixing errors
  - Architecture - Design decisions, refactoring

  Would you like to use any of these commands, or need help with something specific?

> **/flutter-test**
> Unknown slash command: flutter-test

What Should Happen?

When claude tells me it has skills and how to use them its instructions should be correct.

Error Messages/Logs

> Unknown slash command: flutter-test

Steps to Reproduce

Add a skill md file to your project directory, ask claude what skills it has, follow its instructions to run the skill, watch it fail.

Claude Model

Sonnet (default)

Is this a regression?

No, this never worked

Last Working Version

_No response_

Claude Code Version

2.0.25

Platform

Anthropic API

Operating System

Ubuntu/Debian Linux

Terminal/Shell

WSL (Windows Subsystem for Linux)

Additional Information

_No response_

View original on GitHub ↗

5 Comments

Matt-PMCT · 11 months ago

please ignore the double stars in the code block, I tried to bold it and forgot I couldn't

github-actions[bot] · 11 months ago

Found 3 possible duplicate issues:

  1. https://github.com/anthropics/claude-code/issues/9716
  2. https://github.com/anthropics/claude-code/issues/10061
  3. https://github.com/anthropics/claude-code/issues/9954

This issue will be automatically closed as a duplicate in 3 days.

  • If your issue is a duplicate, please close it and 👍 the existing issue instead
  • To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

Matt-PMCT · 11 months ago

Sigh. I figured it out. When I asked Claude to create the skills it named it flutter-test.md in the skills folder. Turns out Claude is dumb and it needs to be a sub-folder with a SKILL.md file inside of it...

dklotz01 · 11 months ago

I'm experiencing the same and I have it under .claude/skills/my-skill/SKILL.md . And claude code seems to be ignoring it.

github-actions[bot] · 11 months ago

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.