Skip to content

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

@eloimarquessilva

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
    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