Skip to content

[Bug]: Gemini and Codex --ai-skills on Windows 11 does not install skills #1915

Description

@eloimarquessilva

Bug Description

On Windows, specify init --ai gemini --ai-skills initializes the project, downloads/extracts the Gemini template, but does not install any skills.

The project ends up in the normal slash-command flow (/speckit.*) instead of creating bundled skills.

This appears to be Gemini-specific in my testing:

  • Gemini: fails on v0.2.1, v0.3.1, and v0.3.2
  • Codex: --ai-skills worked for me on v0.3.1, but failed on v0.3.2 (possible separate regression)

Steps to Reproduce

Run the following command in a project root on Windows:

specify init --here --force --ai gemini --ai-skills --script ps

Also reproduced with pinned older versions using uvx:

uvx --from git+https://github.com/github/spec-kit.git@v0.3.1 specify init --here --force --ai gemini --ai-skills --script ps
uvx --from git+https://github.com/github/spec-kit.git@v0.2.1 specify init --here --force --ai gemini --ai-skills --script ps

Expected Behavior

When using:

specify init --here --force --ai gemini --ai-skills --script ps

Spec Kit should install the Gemini agent skills successfully (e.g., creating a .agents/skills directory with the bundled skills), instead of falling back to the slash-command flow (/speckit.*).

Actual Behavior

The init process runs, downloads the Gemini template, extracts it, and finishes with Project ready, but the Install agent skills step fails silently with "command templates not found":

- Install agent skills (command templates not found)

After that, the tool shows the normal slash-command next steps instead of bundled skills:

  • /speckit.constitution
  • /speckit.specify
  • /speckit.plan
  • /speckit.tasks
  • /speckit.implement

No .agents/skills directory is created.

Specify CLI Version

0.3.2

AI Agent

Gemini CLI

Operating System

Windows 10.0.26200 (AMD64)

Python Version

Python 3.13.0

Error Logs

Selected AI assistant: gemini
Selected script type: ps
Initialize Specify Project

- Check required tools (ok)
- Select AI assistant (gemini)
- Select script type (ps)
- Fetch latest release (release v0.3.2 ...)
- Download template (spec-kit-template-gemini-ps-v0.3.2.zip)
- Extract template
- Archive contents
- Extraction summary
- Ensure scripts executable
- Constitution setup (existing file preserved)
- Install agent skills (command templates not found)
- Cleanup
- Initialize git repository (existing repo detected)
- Finalize (project ready)

Additional Context

Version matrix

Version Gemini --ai-skills Result
v0.2.1 tested fails
v0.3.1 tested fails
v0.3.2 tested fails

Additional notes for comparison:

  • Codex --ai-skills worked on v0.3.1
  • Codex --ai-skills failed on v0.3.2 (possible separate regression)

This suggests:

  • Gemini skills may have a longer-standing issue on Windows
  • Codex may have a separate regression between v0.3.1 and v0.3.2

Other notes:

  • This does not appear to be a PATH problem: specify runs correctly and specify version works.
  • The failure happens specifically during the Install agent skills step.
  • Tested from an existing project directory using --here --force.
  • Screenshots of terminal output will be attached.
Image Image Image

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions