Skip to content

πŸ’« Toolkit to help you get started with SDD or any other process!

feat: add Kimi Code CLI agent support (#1790)

Fanch Daniele56d37db8ccf
diff --git a/.devcontainer/post-create.sh b/.devcontainer/post-create.sh
index 024ff0db4..d7d3da588 100755
--- a/.devcontainer/post-create.sh
+++ b/.devcontainer/post-create.sh
@@ -8,15 +8,15 @@ run_command() {
local command_to_run="$*"
local output
local exit_code
-
+
# Capture all output (stdout and stderr)
output=$(eval "$command_to_run" 2>&1) || exit_code=$?
exit_code=${exit_code:-0}
-
+
if [ $exit_code -ne 0 ]; then
echo -e "\033[0;31m[ERROR] Command failed (Exit Code $exit_code): $command_to_run\033[0m" >&2
echo -e "\033[0;31m$output\033[0m" >&2
-
+
exit $exit_code
fi
}
@@ -53,7 +53,7 @@ echo "βœ… Done"
echo -e "\nπŸ€– Installing Kiro CLI..."
# https://kiro.dev/docs/cli/
-KIRO_INSTALLER_URL="https://cli.kiro.dev/install"
+KIRO_INSTALLER_URL="https://kiro.dev/install.sh"
KIRO_INSTALLER_SHA256="7487a65cf310b7fb59b357c4b5e6e3f3259d383f4394ecedb39acf70f307cffb"
KIRO_INSTALLER_PATH="$(mktemp)"
@@ -80,6 +80,11 @@ fi
run_command "$kiro_binary --help > /dev/null"
echo "βœ… Done"
+echo -e "\nπŸ€– Installing Kimi CLI..."
+# https://code.kimi.com
+run_command "pipx install kimi-cli"
+echo "βœ… Done"
+
echo -e "\nπŸ€– Installing CodeBuddy CLI..."
run_command "npm install -g @tencent-ai/codebuddy-code@latest"
echo "βœ… Done"
diff --git a/.github/workflows/scripts/create-github-release.sh b/.github/workflows/scripts/create-github-release.sh
old mode 100644
new mode 100755
index 29851a140..864e0011b
--- a/.github/workflows/scripts/create-github-release.sh
+++ b/.github/workflows/scripts/create-github-release.sh
@@ -56,6 +56,8 @@ gh release create "$VERSION" \
.genreleases/spec-kit-template-bob-ps-"$VERSION".zip \
.genreleases/spec-kit-template-vibe-sh-"$VERSION".zip \
.genreleases/spec-kit-template-vibe-ps-"$VERSION".zip \
+ .genreleases/spec-kit-template-kimi-sh-"$VERSION".zip \
+ .genreleases/spec-kit-template-kimi-ps-"$VERSION".zip \
.genreleases/spec-kit-template-generic-sh-"$VERSION".zip \
.genreleases/spec-kit-template-generic-ps-"$VERSION".zip \
--title "Spec Kit Templates - $VERSION_NO_V" \
diff --git a/.github/workflows/scripts/create-release-packages.ps1 b/.github/workflows/scripts/create-release-packages.ps1
index 894ab38e7..8c7d4078f 100644
--- a/.github/workflows/scripts/create-release-packages.ps1
+++ b/.github/workflows/scripts/create-release-packages.ps1
@@ -8,13 +8,13 @@
.DESCRIPTION
create-release-packages.ps1 (workflow-local)
Build Spec Kit template release archives for each supported AI assistant and script type.
-
+
.PARAMETER Version
Version string with leading 'v' (e.g., v0.2.0)
.PARAMETER Agents
Comma or space separated subset of agents to build (default: all)
- Valid agents: claude, gemini, copilot, cursor-agent, qwen, opencode, windsurf, codex, kilocode, auggie, roo, codebuddy, amp, kiro-cli, bob, qodercli, shai, tabnine, agy, vibe, generic
+ Valid agents: claude, gemini, copilot, cursor-agent, qwen, opencode, windsurf, codex, kilocode, auggie, roo, codebuddy, amp, kiro-cli, bob, qodercli, shai, tabnine, agy, vibe, kimi, generic
.PARAMETER Scripts
Comma or space separated subset of script types to build (default: both)
@@ -33,10 +33,10 @@
param(
[Parameter(Mandatory=$true, Position=0)]
[string]$Version,
-
+
[Parameter(Mandatory=$false)]
[string]$Agents = "",
-
+
[Parameter(Mandatory=$false)]
[string]$Scripts = ""
)
@@ -60,7 +60,7 @@ New-Item -ItemType Directory -Path $GenReleasesDir -Force | Out-Null
function Rewrite-Paths {
param([string]$Content)
-
+
$Content = $Content -replace '(/?)\bmemory/', '.specify/memory/'
$Content = $Content -replace '(/?)\bscripts/', '.specify/scripts/'
$Content = $Content -replace '(/?)\btemplates/', '.specify/templates/'
@@ -75,55 +75,55 @@ function Generate-Commands {
[string]$OutputDir,
[string]$ScriptVariant
)
-
+
New-Item -ItemType Directory -Path $OutputDir -Force | Out-Null
-
+
$templates = Get-ChildItem -Path "templates/commands/*.md" -File -ErrorAction SilentlyContinue
-
+
foreach ($template in $templates) {
$name = [System.IO.Path]::GetFileNameWithoutExtension($template.Name)
-
+
# Read file content and normalize line endings
$fileContent = (Get-Content -Path $template.FullName -Raw) -replace "`r`n", "`n"
-
+
# Extract description from YAML frontmatter
$description = ""
if ($fileContent -match '(?m)^description:\s*(.+)$') {
$description = $matches[1]
}
-
+
# Extract script command from YAML frontmatter
$scriptCommand = ""
if ($fileContent -match "(?m)^\s*${ScriptVariant}:\s*(.+)$") {
$scriptCommand = $matches[1]
}
-
+
if ([string]::IsNullOrEmpty($scriptCommand)) {
Write-Warning "No script command found for $ScriptVariant in $($template.Name)"
$scriptCommand = "(Missing script command for $ScriptVariant)"
}
-
+
# Extract agent_script command from YAML frontmatter if present
$agentScriptCommand = ""
if ($fileContent -match "(?ms)agent_scripts:.*?^\s*${ScriptVariant}:\s*(.+?)$") {
$agentScriptCommand = $matches[1].Trim()
}
-
+
# Replace {SCRIPT} placeholder with the script command
$body = $fileContent -replace '\{SCRIPT\}', $scriptCommand
-
+
# Replace {AGENT_SCRIPT} placeholder with the agent script command if found
if (-not [string]::IsNullOrEmpty($agentScriptCommand)) {
$body = $body -replace '\{AGENT_SCRIPT\}', $agentScriptCommand
}
-
+
# Remove the scripts: and agent_scripts: sections from frontmatter
$lines = $body -split "`n"
$outputLines = @()
$inFrontmatter = $false
$skipScripts = $false
$dashCount = 0
-
+
foreach ($line in $lines) {
if ($line -match '^---$') {
$outputLines += $line
@@ -135,7 +135,7 @@ function Generate-Commands {
}
continue
}
-
+
if ($inFrontmatter) {
if ($line -match '^(scripts|agent_scripts):$') {
$skipScripts = $true
@@ -148,20 +148,20 @@ function Generate-Commands {
continue
}
}
-
+
$outputLines += $line
}
-
+
$body = $outputLines -join "`n"
-
+
# Apply other substitutions
$body = $body -replace '\{ARGS\}', $ArgFormat
$body = $body -replace '__AGENT__', $Agent
$body = Rewrite-Paths -Content $body
-
+
# Generate output file based on extension
$outputFile = Join-Path $OutputDir "speckit.$name.$Extension"
-
+
switch ($Extension) {
'toml' {
$body = $body -replace '\\', '\\'
@@ -183,15 +183,15 @@ function Generate-CopilotPrompts {
[string]$AgentsDir,
[string]$PromptsDir
)
-
+
New-Item -ItemType Directory -Path $PromptsDir -Force | Out-Null
-
+
$agentFiles = Get-ChildItem -Path "$AgentsDir/speckit.*.agent.md" -File -ErrorAction SilentlyContinue
-
+
foreach ($agentFile in $agentFiles) {
$basename = $agentFile.Name -replace '\.agent\.md$', ''
$promptFile = Join-Path $PromptsDir "$basename.prompt.md"
-
+
$content = @"
---
agent: $basename
@@ -201,31 +201,118 @@ agent: $basename
}
}
+# Create Kimi Code skills in .kimi/skills/<name>/SKILL.md format.
+# Kimi CLI discovers skills as directories containing a SKILL.md file,
+# invoked with /skill:<name> (e.g. /skill:speckit.specify).
+function New-KimiSkills {
+ param(
+ [string]$SkillsDir,
+ [string]$ScriptVariant
+ )
+
+ $templates = Get-ChildItem -Path "templates/commands/*.md" -File -ErrorAction SilentlyContinue
+
+ foreach ($template in $templates) {
+ $name = [System.IO.Path]::GetFileNameWithoutExtension($template.Name)
+ $skillName = "speckit.$name"
+ $skillDir = Join-Path $SkillsDir $skillName
+ New-Item -ItemType Directory -Force -Path $skillDir | Out-Null
+
+ $fileContent = (Get-Content -Path $template.FullName -Raw) -replace "`r`n", "`n"
+
+ # Extract description
+ $description = "Spec Kit: $name workflow"
+ if ($fileContent -match '(?m)^description:\s*(.+)$') {
+ $description = $matches[1]
+ }
+
+ # Extract script command
+ $scriptCommand = "(Missing script command for $ScriptVariant)"
+ if ($fileContent -match "(?m)^\s*${ScriptVariant}:\s*(.+)$") {
+ $scriptCommand = $matches[1]
+ }
+
+ # Extract agent_script command from frontmatter if present
+ $agentScriptCommand = ""
+ if ($fileContent -match "(?ms)agent_scripts:.*?^\s*${ScriptVariant}:\s*(.+?)$") {
+ $agentScriptCommand = $matches[1].Trim()
+ }
+
+ # Replace {SCRIPT}, strip scripts sections, rewrite paths
+ $body = $fileContent -replace '\{SCRIPT\}', $scriptCommand
+ if (-not [string]::IsNullOrEmpty($agentScriptCommand)) {
+ $body = $body -replace '\{AGENT_SCRIPT\}', $agentScriptCommand
+ }
+
+ $lines = $body -split "`n"
+ $outputLines = @()
+ $inFrontmatter = $false
+ $skipScripts = $false
+ $dashCount = 0
+
+ foreach ($line in $lines) {
+ if ($line -match '^---$') {
+ $outputLines += $line
+ $dashCount++
+ $inFrontmatter = ($dashCount -eq 1)
+ continue
+ }
+ if ($inFrontmatter) {
+ if ($line -match '^(scripts|agent_scripts):$') { $skipScripts = $true; continue }
+ if ($line -match '^[a-zA-Z].*:' -and $skipScripts) { $skipScripts = $false }
+ if ($skipScripts -and $line -match '^\s+') { continue }
+ }
+ $outputLines += $line
+ }
+
+ $body = $outputLines -join "`n"
+ $body = $body -replace '\{ARGS\}', '$ARGUMENTS'
+ $body = $body -replace '__AGENT__', 'kimi'
+ $body = Rewrite-Paths -Content $body
+
+ # Strip existing frontmatter, keep only body
+ $templateBody = ""
+ $fmCount = 0
+ $inBody = $false
+ foreach ($line in ($body -split "`n")) {
+ if ($line -match '^---$') {
+ $fmCount++
+ if ($fmCount -eq 2) { $inBody = $true }
+ continue
+ }
+ if ($inBody) { $templateBody += "$line`n" }
+ }
+
+ $skillContent = "---`nname: `"$skillName`"`ndescription: `"$description`"`n---`n`n$templateBody"
+ Set-Content -Path (Join-Path $skillDir "SKILL.md") -Value $skillContent -NoNewline
+ }
+}
+
function Build-Variant {
param(
[string]$Agent,
[string]$Script
)
-
+
$baseDir = Join-Path $GenReleasesDir "sdd-${Agent}-package-${Script}"
Write-Host "Building $Agent ($Script) package..."
New-Item -ItemType Directory -Path $baseDir -Force | Out-Null
-
+
# Copy base structure but filter scripts by variant
$specDir = Join-Path $baseDir ".specify"
New-Item -ItemType Directory -Path $specDir -Force | Out-Null
-
+
# Copy memory directory
if (Test-Path "memory") {
Copy-Item -Path "memory" -Destination $specDir -Recurse -Force
Write-Host "Copied memory -> .specify"
}
-
+
# Only copy the relevant script variant directory
if (Test-Path "scripts") {
$scriptsDestDir = Join-Path $specDir "scripts"
New-Item -ItemType Directory -Path $scriptsDestDir -Force | Out-Null
-
+
switch ($Script) {
'sh' {
if (Test-Path "scripts/bash") {
@@ -240,18 +327,17 @@ function Build-Variant {
}
}
}
-
- # Copy any script files that aren't in variant-specific directories
+
Get-ChildItem -Path "scripts" -File -ErrorAction SilentlyContinue | ForEach-Object {
Copy-Item -Path $_.FullName -Destination $scriptsDestDir -Force
}
}
-
+
# Copy templates (excluding commands directory and vscode-settings.json)
if (Test-Path "templates") {
$templatesDestDir = Join-Path $specDir "templates"
New-Item -ItemType Directory -Path $templatesDestDir -Force | Out-Null
-
+
Get-ChildItem -Path "templates" -Recurse -File | Where-Object {
$_.FullName -notmatch 'templates[/\\]commands[/\\]' -and $_.Name -ne 'vscode-settings.json'
} | ForEach-Object {
@@ -263,7 +349,7 @@ function Build-Variant {
}
Write-Host "Copied templates -> .specify/templates"
}
-
+
# Generate agent-specific command files
switch ($Agent) {
'claude' {
@@ -280,12 +366,10 @@ function Build-Variant {
'copilot' {
$agentsDir = Join-Path $baseDir ".github/agents"
Generate-Commands -Agent 'copilot' -Extension 'agent.md' -ArgFormat '$ARGUMENTS' -OutputDir $agentsDir -ScriptVariant $Script
-
- # Generate companion prompt files
+
$promptsDir = Join-Path $baseDir ".github/prompts"
Generate-CopilotPrompts -AgentsDir $agentsDir -PromptsDir $promptsDir
-
- # Create VS Code workspace settings
+
$vscodeDir = Join-Path $baseDir ".vscode"
New-Item -ItemType Directory -Path $vscodeDir -Force | Out-Null
if (Test-Path "templates/vscode-settings.json") {
@@ -361,19 +445,24 @@ function Build-Variant {
$cmdDir = Join-Path $baseDir ".agent/workflows"
Generate-Commands -Agent 'agy' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
}
- 'generic' {
- $cmdDir = Join-Path $baseDir ".speckit/commands"
- Generate-Commands -Agent 'generic' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
- }
'vibe' {
$cmdDir = Join-Path $baseDir ".vibe/prompts"
Generate-Commands -Agent 'vibe' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
}
+ 'kimi' {
+ $skillsDir = Join-Path $baseDir ".kimi/skills"
+ New-Item -ItemType Directory -Force -Path $skillsDir | Out-Null
+ New-KimiSkills -SkillsDir $skillsDir -ScriptVariant $Script
+ }
+ 'generic' {
+ $cmdDir = Join-Path $baseDir ".speckit/commands"
+ Generate-Commands -Agent 'generic' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
+ }
default {
throw "Unsupported agent '$Agent'."
}
}
-
+
# Create zip archive
$zipFile = Join-Path $GenReleasesDir "spec-kit-template-${Agent}-${Script}-${Version}.zip"
Compress-Archive -Path "$baseDir/*" -DestinationPath $zipFile -Force
@@ -381,17 +470,16 @@ function Build-Variant {
}
# Define all agents and scripts
-$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp', 'kiro-cli', 'bob', 'qodercli', 'shai', 'tabnine', 'agy', 'vibe', 'generic')
+$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp', 'kiro-cli', 'bob', 'qodercli', 'shai', 'tabnine', 'agy', 'vibe', 'kimi', 'generic')
$AllScripts = @('sh', 'ps')
function Normalize-List {
param([string]$Input)
-
+
if ([string]::IsNullOrEmpty($Input)) {
return @()
}
-
- # Split by comma or space and remove duplicates while preserving order
+
$items = $Input -split '[,\s]+' | Where-Object { $_ } | Select-Object -Unique
return $items
}
@@ -402,7 +490,7 @@ function Validate-Subset {
[string[]]$Allowed,
[string[]]$Items
)
-
+
$ok = $true
foreach ($item in $Items) {
if ($item -notin $Allowed) {
diff --git a/.github/workflows/scripts/create-release-packages.sh b/.github/workflows/scripts/create-release-packages.sh
index af9880b61..8be5a0549 100755
--- a/.github/workflows/scripts/create-release-packages.sh
+++ b/.github/workflows/scripts/create-release-packages.sh
@@ -6,7 +6,7 @@ set -euo pipefail
# Usage: .github/workflows/scripts/create-release-packages.sh <version>
# Version argument should include leading 'v'.
# Optionally set AGENTS and/or SCRIPTS env vars to limit what gets built.
-# AGENTS : space or comma separated subset of: claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli generic (default: all)
+# AGENTS : space or comma separated subset of: claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli kimi generic (default: all)
# SCRIPTS : space or comma separated subset of: sh ps (default: both)
# Examples:
# AGENTS=claude SCRIPTS=sh $0 v0.2.0
@@ -45,19 +45,19 @@ generate_commands() {
[[ -f "$template" ]] || continue
local name description script_command agent_script_command body
name=$(basename "$template" .md)
-
+
# Normalize line endings
file_content=$(tr -d '\r' < "$template")
-
+
# Extract description and script command from YAML frontmatter
description=$(printf '%s\n' "$file_content" | awk '/^description:/ {sub(/^description:[[:space:]]*/, ""); print; exit}')
script_command=$(printf '%s\n' "$file_content" | awk -v sv="$script_variant" '/^[[:space:]]*'"$script_variant"':[[:space:]]*/ {sub(/^[[:space:]]*'"$script_variant"':[[:space:]]*/, ""); print; exit}')
-
+
if [[ -z $script_command ]]; then
echo "Warning: no script command found for $script_variant in $template" >&2
script_command="(Missing script command for $script_variant)"
fi
-
+
# Extract agent_script command from YAML frontmatter if present
agent_script_command=$(printf '%s\n' "$file_content" | awk '
/^agent_scripts:$/ { in_agent_scripts=1; next }
@@ -68,15 +68,15 @@ generate_commands() {
}
in_agent_scripts && /^[a-zA-Z]/ { in_agent_scripts=0 }
')
-
+
# Replace {SCRIPT} placeholder with the script command
body=$(printf '%s\n' "$file_content" | sed "s|{SCRIPT}|${script_command}|g")
-
+
# Replace {AGENT_SCRIPT} placeholder with the agent script command if found
if [[ -n $agent_script_command ]]; then
body=$(printf '%s\n' "$body" | sed "s|{AGENT_SCRIPT}|${agent_script_command}|g")
fi
-
+
# Remove the scripts: and agent_scripts: sections from frontmatter while preserving YAML structure
body=$(printf '%s\n' "$body" | awk '
/^---$/ { print; if (++dash_count == 1) in_frontmatter=1; else in_frontmatter=0; next }
@@ -86,10 +86,10 @@ generate_commands() {
in_frontmatter && skip_scripts && /^[[:space:]]/ { next }
{ print }
')
-
+
# Apply other substitutions
body=$(printf '%s\n' "$body" | sed "s/{ARGS}/$arg_format/g" | sed "s/__AGENT__/$agent/g" | rewrite_paths)
-
+
case $ext in
toml)
body=$(printf '%s\n' "$body" | sed 's/\\/\\\\/g')
@@ -105,15 +105,14 @@ generate_commands() {
generate_copilot_prompts() {
local agents_dir=$1 prompts_dir=$2
mkdir -p "$prompts_dir"
-
+
# Generate a .prompt.md file for each .agent.md file
for agent_file in "$agents_dir"/speckit.*.agent.md; do
[[ -f "$agent_file" ]] || continue
-
+
local basename=$(basename "$agent_file" .agent.md)
local prompt_file="$prompts_dir/${basename}.prompt.md"
-
- # Create prompt file with agent frontmatter
+
cat > "$prompt_file" <<EOF
---
agent: ${basename}
@@ -122,41 +121,104 @@ EOF
done
}
+# Create Kimi Code skills in .kimi/skills/<name>/SKILL.md format.
+# Kimi CLI discovers skills as directories containing a SKILL.md file,
+# invoked with /skill:<name> (e.g. /skill:speckit.specify).
+create_kimi_skills() {
+ local skills_dir="$1"
+ local script_variant="$2"
+
+ for template in templates/commands/*.md; do
+ [[ -f "$template" ]] || continue
+ local name
+ name=$(basename "$template" .md)
+ local skill_name="speckit.${name}"
+ local skill_dir="${skills_dir}/${skill_name}"
+ mkdir -p "$skill_dir"
+
+ local file_content
+ file_content=$(tr -d '\r' < "$template")
+
+ # Extract description from frontmatter
+ local description
+ description=$(printf '%s\n' "$file_content" | awk '/^description:/ {sub(/^description:[[:space:]]*/, ""); print; exit}')
+ [[ -z "$description" ]] && description="Spec Kit: ${name} workflow"
+
+ # Extract script command
+ local script_command
+ script_command=$(printf '%s\n' "$file_content" | awk -v sv="$script_variant" '/^[[:space:]]*'"$script_variant"':[[:space:]]*/ {sub(/^[[:space:]]*'"$script_variant"':[[:space:]]*/, ""); print; exit}')
+ [[ -z "$script_command" ]] && script_command="(Missing script command for $script_variant)"
+
+ # Extract agent_script command from frontmatter if present
+ local agent_script_command
+ agent_script_command=$(printf '%s\n' "$file_content" | awk '
+ /^agent_scripts:$/ { in_agent_scripts=1; next }
+ in_agent_scripts && /^[[:space:]]*'"$script_variant"':[[:space:]]*/ {
+ sub(/^[[:space:]]*'"$script_variant"':[[:space:]]*/, "")
+ print
+ exit
+ }
+ in_agent_scripts && /^[a-zA-Z]/ { in_agent_scripts=0 }
+ ')
+
+ # Build body: replace placeholders, strip scripts sections, rewrite paths
+ local body
+ body=$(printf '%s\n' "$file_content" | sed "s|{SCRIPT}|${script_command}|g")
+ if [[ -n $agent_script_command ]]; then
+ body=$(printf '%s\n' "$body" | sed "s|{AGENT_SCRIPT}|${agent_script_command}|g")
+ fi
+ body=$(printf '%s\n' "$body" | awk '
+ /^---$/ { print; if (++dash_count == 1) in_frontmatter=1; else in_frontmatter=0; next }
+ in_frontmatter && /^scripts:$/ { skip_scripts=1; next }
+ in_frontmatter && /^agent_scripts:$/ { skip_scripts=1; next }
+ in_frontmatter && /^[a-zA-Z].*:/ && skip_scripts { skip_scripts=0 }
+ in_frontmatter && skip_scripts && /^[[:space:]]/ { next }
+ { print }
+ ')
+ body=$(printf '%s\n' "$body" | sed 's/{ARGS}/\$ARGUMENTS/g' | sed 's/__AGENT__/kimi/g' | rewrite_paths)
+
+ # Strip existing frontmatter and prepend Kimi frontmatter
+ local template_body
+ template_body=$(printf '%s\n' "$body" | awk '/^---/{p++; if(p==2){found=1; next}} found')
+
+ {
+ printf -- '---\n'
+ printf 'name: "%s"\n' "$skill_name"
+ printf 'description: "%s"\n' "$description"
+ printf -- '---\n\n'
+ printf '%s\n' "$template_body"
+ } > "$skill_dir/SKILL.md"
+ done
+}
+
build_variant() {
local agent=$1 script=$2
local base_dir="$GENRELEASES_DIR/sdd-${agent}-package-${script}"
echo "Building $agent ($script) package..."
mkdir -p "$base_dir"
-
+
# Copy base structure but filter scripts by variant
SPEC_DIR="$base_dir/.specify"
mkdir -p "$SPEC_DIR"
-
+
[[ -d memory ]] && { cp -r memory "$SPEC_DIR/"; echo "Copied memory -> .specify"; }
-
+
# Only copy the relevant script variant directory
if [[ -d scripts ]]; then
mkdir -p "$SPEC_DIR/scripts"
case $script in
sh)
[[ -d scripts/bash ]] && { cp -r scripts/bash "$SPEC_DIR/scripts/"; echo "Copied scripts/bash -> .specify/scripts"; }
- # Copy any script files that aren't in variant-specific directories
find scripts -maxdepth 1 -type f -exec cp {} "$SPEC_DIR/scripts/" \; 2>/dev/null || true
;;
ps)
[[ -d scripts/powershell ]] && { cp -r scripts/powershell "$SPEC_DIR/scripts/"; echo "Copied scripts/powershell -> .specify/scripts"; }
- # Copy any script files that aren't in variant-specific directories
find scripts -maxdepth 1 -type f -exec cp {} "$SPEC_DIR/scripts/" \; 2>/dev/null || true
;;
esac
fi
-
+
[[ -d templates ]] && { mkdir -p "$SPEC_DIR/templates"; find templates -type f -not -path "templates/commands/*" -not -name "vscode-settings.json" -exec cp --parents {} "$SPEC_DIR"/ \; ; echo "Copied templates -> .specify/templates"; }
-
- # NOTE: We substitute {ARGS} internally. Outward tokens differ intentionally:
- # * Markdown/prompt (claude, copilot, cursor-agent, opencode): $ARGUMENTS
- # * TOML (gemini, qwen, tabnine): {{args}}
- # This keeps formats readable without extra abstraction.
case $agent in
claude)
@@ -169,9 +231,7 @@ build_variant() {
copilot)
mkdir -p "$base_dir/.github/agents"
generate_commands copilot agent.md "\$ARGUMENTS" "$base_dir/.github/agents" "$script"
- # Generate companion prompt files
generate_copilot_prompts "$base_dir/.github/agents" "$base_dir/.github/prompts"
- # Create VS Code workspace settings
mkdir -p "$base_dir/.vscode"
[[ -f templates/vscode-settings.json ]] && cp templates/vscode-settings.json "$base_dir/.vscode/settings.json"
;;
@@ -228,6 +288,9 @@ build_variant() {
vibe)
mkdir -p "$base_dir/.vibe/prompts"
generate_commands vibe md "\$ARGUMENTS" "$base_dir/.vibe/prompts" "$script" ;;
+ kimi)
+ mkdir -p "$base_dir/.kimi/skills"
+ create_kimi_skills "$base_dir/.kimi/skills" "$script" ;;
generic)
mkdir -p "$base_dir/.speckit/commands"
generate_commands generic md "\$ARGUMENTS" "$base_dir/.speckit/commands" "$script" ;;
@@ -237,11 +300,10 @@ build_variant() {
}
# Determine agent list
-ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli generic)
+ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli kimi generic)
ALL_SCRIPTS=(sh ps)
norm_list() {
- # convert comma+space separated -> line separated unique while preserving order of first occurrence
tr ',\n' ' ' | awk '{for(i=1;i<=NF;i++){if(!seen[$i]++){printf((out?"\n":"") $i);out=1}}}END{printf("\n")}'
}
diff --git a/AGENTS.md b/AGENTS.md
index 8e7631b1d..aa3730222 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -48,6 +48,7 @@ Specify supports multiple AI agents by generating agent-specific command files a
| **Amp** | `.agents/commands/` | Markdown | `amp` | Amp CLI |
| **SHAI** | `.shai/commands/` | Markdown | `shai` | SHAI CLI |
| **Tabnine CLI** | `.tabnine/agent/commands/` | TOML | `tabnine` | Tabnine CLI |
+| **Kimi Code** | `.kimi/skills/` | Markdown | `kimi` | Kimi Code CLI (Moonshot AI) |
| **IBM Bob** | `.bob/commands/` | Markdown | N/A (IDE-based) | IBM Bob IDE |
| **Generic** | User-specified via `--ai-commands-dir` | Markdown | N/A | Bring your own agent |
@@ -324,6 +325,7 @@ Require a command-line tool to be installed:
- **Amp**: `amp` CLI
- **SHAI**: `shai` CLI
- **Tabnine CLI**: `tabnine` CLI
+- **Kimi Code**: `kimi` CLI
### IDE-Based Agents
@@ -337,7 +339,7 @@ Work within integrated development environments:
### Markdown Format
-Used by: Claude, Cursor, opencode, Windsurf, Kiro CLI, Amp, SHAI, IBM Bob
+Used by: Claude, Cursor, opencode, Windsurf, Kiro CLI, Amp, SHAI, IBM Bob, Kimi Code
**Standard format:**
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 45b662160..ac96960d7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -17,6 +17,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
### Changed
+- feat: add Kimi Code CLI agent support
- fix: sync agent list comments with actual supported agents (#1785)
- feat(extensions): support multiple active catalogs simultaneously (#1720)
- Pavel/add tabnine cli support (#1503)
diff --git a/README.md b/README.md
index c3afd1846..5aca4901c 100644
--- a/README.md
+++ b/README.md
@@ -179,6 +179,7 @@ See Spec-Driven Development in action across different scenarios with these comm
| [SHAI (OVHcloud)](https://github.com/ovh/shai) | βœ… | |
| [Tabnine CLI](https://docs.tabnine.com/main/getting-started/tabnine-cli) | βœ… | |
| [Mistral Vibe](https://github.com/mistralai/mistral-vibe) | βœ… | |
+| [Kimi Code](https://code.kimi.com/) | βœ… | |
| [Windsurf](https://windsurf.com/) | βœ… | |
| [Antigravity (agy)](https://antigravity.google/) | βœ… | |
| Generic | βœ… | Bring your own agent β€” use `--ai generic --ai-commands-dir <path>` for unsupported agents |
@@ -192,14 +193,14 @@ The `specify` command supports the following options:
| Command | Description |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `init` | Initialize a new Specify project from the latest template |
-| `check` | Check for installed tools (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `kiro-cli`, `shai`, `qodercli`, `vibe`) |
+| `check` | Check for installed tools (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `kiro-cli`, `shai`, `qodercli`, `vibe`, `kimi`) |
### `specify init` Arguments & Options
| Argument/Option | Type | Description |
| ---------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `<project-name>` | Argument | Name for your new project directory (optional if using `--here`, or use `.` for current directory) |
-| `--ai` | Option | AI assistant to use: `claude`, `gemini`, `copilot`, `cursor-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, `shai`, `kiro-cli` (`kiro` alias), `agy`, `bob`, `qodercli`, `vibe`, or `generic` (requires `--ai-commands-dir`) |
+| `--ai` | Option | AI assistant to use: `claude`, `gemini`, `copilot`, `cursor-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, `shai`, `kiro-cli` (`kiro` alias), `agy`, `bob`, `qodercli`, `vibe`, `kimi`, or `generic` (requires `--ai-commands-dir`) |
| `--ai-commands-dir` | Option | Directory for agent command files (required with `--ai generic`, e.g. `.myagent/commands/`) |
| `--script` | Option | Script variant to use: `sh` (bash/zsh) or `ps` (PowerShell) |
| `--ignore-agent-tools` | Flag | Skip checks for AI agent tools like Claude Code |
diff --git a/scripts/bash/update-agent-context.sh b/scripts/bash/update-agent-context.sh
index f67e2db99..b0022fd45 100644
--- a/scripts/bash/update-agent-context.sh
+++ b/scripts/bash/update-agent-context.sh
@@ -30,12 +30,12 @@
#
# 5. Multi-Agent Support
# - Handles agent-specific file paths and naming conventions
-# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Qoder CLI, Amp, SHAI, Tabnine CLI, Kiro CLI, Mistral Vibe, Antigravity or Generic
+# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Qoder CLI, Amp, SHAI, Tabnine CLI, Kiro CLI, Mistral Vibe, Kimi Code, Antigravity or Generic
# - Can update single agents or all existing agent files
# - Creates default Claude file if no agent files exist
#
# Usage: ./update-agent-context.sh [agent_type]
-# Agent types: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|generic
+# Agent types: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|generic
# Leave empty to update all existing agent files
set -e
@@ -78,6 +78,7 @@ KIRO_FILE="$REPO_ROOT/AGENTS.md"
AGY_FILE="$REPO_ROOT/.agent/rules/specify-rules.md"
BOB_FILE="$REPO_ROOT/AGENTS.md"
VIBE_FILE="$REPO_ROOT/.vibe/agents/specify-agents.md"
+KIMI_FILE="$REPO_ROOT/KIMI.md"
# Template file
TEMPLATE_FILE="$REPO_ROOT/.specify/templates/agent-file-template.md"
@@ -665,12 +666,15 @@ update_specific_agent() {
vibe)
update_agent_file "$VIBE_FILE" "Mistral Vibe"
;;
+ kimi)
+ update_agent_file "$KIMI_FILE" "Kimi Code"
+ ;;
generic)
log_info "Generic agent: no predefined context file. Use the agent-specific update script for your agent."
;;
*)
log_error "Unknown agent type '$agent_type'"
- log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|generic"
+ log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|generic"
exit 1
;;
esac
@@ -769,6 +773,11 @@ update_all_existing_agents() {
found_agent=true
fi
+ if [[ -f "$KIMI_FILE" ]]; then
+ update_agent_file "$KIMI_FILE" "Kimi Code"
+ found_agent=true
+ fi
+
# If no agent files exist, create a default Claude file
if [[ "$found_agent" == false ]]; then
log_info "No existing agent files found, creating default Claude file..."
@@ -792,7 +801,7 @@ print_summary() {
fi
echo
- log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|generic]"
+ log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|generic]"
}
#==============================================================================
diff --git a/scripts/powershell/update-agent-context.ps1 b/scripts/powershell/update-agent-context.ps1
index 816d4d586..95e636ba1 100644
--- a/scripts/powershell/update-agent-context.ps1
+++ b/scripts/powershell/update-agent-context.ps1
@@ -9,7 +9,7 @@ Mirrors the behavior of scripts/bash/update-agent-context.sh:
2. Plan Data Extraction
3. Agent File Management (create from template or update existing)
4. Content Generation (technology stack, recent changes, timestamp)
- 5. Multi-Agent Support (claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, roo, codebuddy, amp, shai, tabnine, kiro-cli, agy, bob, vibe, qodercli, generic)
+ 5. Multi-Agent Support (claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, roo, codebuddy, amp, shai, tabnine, kiro-cli, agy, bob, vibe, qodercli, kimi, generic)
.PARAMETER AgentType
Optional agent key to update a single agent. If omitted, updates all existing agent files (creating a default Claude file if none exist).
@@ -25,7 +25,7 @@ Relies on common helper functions in common.ps1
#>
param(
[Parameter(Position=0)]
- [ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','shai','tabnine','kiro-cli','agy','bob','qodercli','vibe','generic')]
+ [ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','shai','tabnine','kiro-cli','agy','bob','qodercli','vibe','kimi','generic')]
[string]$AgentType
)
@@ -63,6 +63,7 @@ $KIRO_FILE = Join-Path $REPO_ROOT 'AGENTS.md'
$AGY_FILE = Join-Path $REPO_ROOT '.agent/rules/specify-rules.md'
$BOB_FILE = Join-Path $REPO_ROOT 'AGENTS.md'
$VIBE_FILE = Join-Path $REPO_ROOT '.vibe/agents/specify-agents.md'
+$KIMI_FILE = Join-Path $REPO_ROOT 'KIMI.md'
$TEMPLATE_FILE = Join-Path $REPO_ROOT '.specify/templates/agent-file-template.md'
@@ -406,8 +407,9 @@ function Update-SpecificAgent {
'agy' { Update-AgentFile -TargetFile $AGY_FILE -AgentName 'Antigravity' }
'bob' { Update-AgentFile -TargetFile $BOB_FILE -AgentName 'IBM Bob' }
'vibe' { Update-AgentFile -TargetFile $VIBE_FILE -AgentName 'Mistral Vibe' }
+ 'kimi' { Update-AgentFile -TargetFile $KIMI_FILE -AgentName 'Kimi Code' }
'generic' { Write-Info 'Generic agent: no predefined context file. Use the agent-specific update script for your agent.' }
- default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|generic'; return $false }
+ default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|generic'; return $false }
}
}
@@ -432,6 +434,7 @@ function Update-AllExistingAgents {
if (Test-Path $AGY_FILE) { if (-not (Update-AgentFile -TargetFile $AGY_FILE -AgentName 'Antigravity')) { $ok = $false }; $found = $true }
if (Test-Path $BOB_FILE) { if (-not (Update-AgentFile -TargetFile $BOB_FILE -AgentName 'IBM Bob')) { $ok = $false }; $found = $true }
if (Test-Path $VIBE_FILE) { if (-not (Update-AgentFile -TargetFile $VIBE_FILE -AgentName 'Mistral Vibe')) { $ok = $false }; $found = $true }
+ if (Test-Path $KIMI_FILE) { if (-not (Update-AgentFile -TargetFile $KIMI_FILE -AgentName 'Kimi Code')) { $ok = $false }; $found = $true }
if (-not $found) {
Write-Info 'No existing agent files found, creating default Claude file...'
if (-not (Update-AgentFile -TargetFile $CLAUDE_FILE -AgentName 'Claude Code')) { $ok = $false }
diff --git a/src/specify_cli/__init__.py b/src/specify_cli/__init__.py
index 209632a70..dac7eaa54 100644
--- a/src/specify_cli/__init__.py
+++ b/src/specify_cli/__init__.py
@@ -265,6 +265,13 @@ AGENT_CONFIG = {
"install_url": "https://github.com/mistralai/mistral-vibe",
"requires_cli": True,
},
+ "kimi": {
+ "name": "Kimi Code",
+ "folder": ".kimi/",
+ "commands_subdir": "skills", # Kimi uses /skill:<name> with .kimi/skills/<name>/SKILL.md
+ "install_url": "https://code.kimi.com/",
+ "requires_cli": True,
+ },
"generic": {
"name": "Generic (bring your own agent)",
"folder": None, # Set dynamically via --ai-commands-dir
@@ -1188,7 +1195,12 @@ def install_ai_skills(project_path: Path, selected_ai: str, tracker: StepTracker
# SKILL_DESCRIPTIONS lookups work.
if command_name.startswith("speckit."):
command_name = command_name[len("speckit."):]
- skill_name = f"speckit-{command_name}"
+ # Kimi CLI discovers skills by directory name and invokes them as
+ # /skill:<name> β€” use dot separator to match packaging convention.
+ if selected_ai == "kimi":
+ skill_name = f"speckit.{command_name}"
+ else:
+ skill_name = f"speckit-{command_name}"
# Create skill directory (additive β€” never removes existing content)
skill_dir = skills_dir / skill_name
diff --git a/src/specify_cli/extensions.py b/src/specify_cli/extensions.py
index 53777bd6b..383ed2154 100644
--- a/src/specify_cli/extensions.py
+++ b/src/specify_cli/extensions.py
@@ -727,7 +727,7 @@ class CommandRegistrar:
"extension": ".md"
},
"roo": {
- "dir": ".roo/rules",
+ "dir": ".roo/commands",
"format": "markdown",
"args": "$ARGUMENTS",
"extension": ".md"
@@ -773,6 +773,12 @@ class CommandRegistrar:
"format": "markdown",
"args": "$ARGUMENTS",
"extension": ".md"
+ },
+ "kimi": {
+ "dir": ".kimi/skills",
+ "format": "markdown",
+ "args": "$ARGUMENTS",
+ "extension": "/SKILL.md"
}
}
@@ -966,6 +972,7 @@ class CommandRegistrar:
# Write command file
dest_file = commands_dir / f"{cmd_name}{agent_config['extension']}"
+ dest_file.parent.mkdir(parents=True, exist_ok=True)
dest_file.write_text(output)
# Generate companion .prompt.md for Copilot agents
@@ -977,6 +984,7 @@ class CommandRegistrar:
# Register aliases
for alias in cmd_info.get("aliases", []):
alias_file = commands_dir / f"{alias}{agent_config['extension']}"
+ alias_file.parent.mkdir(parents=True, exist_ok=True)
alias_file.write_text(output)
# Generate companion .prompt.md for alias too
if agent_name == "copilot":
diff --git a/tests/test_agent_config_consistency.py b/tests/test_agent_config_consistency.py
index 3615dbc78..d77c6f10d 100644
--- a/tests/test_agent_config_consistency.py
+++ b/tests/test_agent_config_consistency.py
@@ -171,3 +171,58 @@ class TestAgentConfigConsistency:
def test_ai_help_includes_tabnine(self):
"""CLI help text for --ai should include tabnine."""
assert "tabnine" in AI_ASSISTANT_HELP
+
+ # --- Kimi Code CLI consistency checks ---
+
+ def test_kimi_in_agent_config(self):
+ """AGENT_CONFIG should include kimi with correct folder and commands_subdir."""
+ assert "kimi" in AGENT_CONFIG
+ assert AGENT_CONFIG["kimi"]["folder"] == ".kimi/"
+ assert AGENT_CONFIG["kimi"]["commands_subdir"] == "skills"
+ assert AGENT_CONFIG["kimi"]["requires_cli"] is True
+
+ def test_kimi_in_extension_registrar(self):
+ """Extension command registrar should include kimi using .kimi/skills and SKILL.md."""
+ cfg = CommandRegistrar.AGENT_CONFIGS
+
+ assert "kimi" in cfg
+ kimi_cfg = cfg["kimi"]
+ assert kimi_cfg["dir"] == ".kimi/skills"
+ assert kimi_cfg["extension"] == "/SKILL.md"
+
+ def test_kimi_in_release_agent_lists(self):
+ """Bash and PowerShell release scripts should include kimi in agent lists."""
+ sh_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.sh").read_text(encoding="utf-8")
+ ps_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.ps1").read_text(encoding="utf-8")
+
+ sh_match = re.search(r"ALL_AGENTS=\(([^)]*)\)", sh_text)
+ assert sh_match is not None
+ sh_agents = sh_match.group(1).split()
+
+ ps_match = re.search(r"\$AllAgents = @\(([^)]*)\)", ps_text)
+ assert ps_match is not None
+ ps_agents = re.findall(r"'([^']+)'", ps_match.group(1))
+
+ assert "kimi" in sh_agents
+ assert "kimi" in ps_agents
+
+ def test_kimi_in_powershell_validate_set(self):
+ """PowerShell update-agent-context script should include 'kimi' in ValidateSet."""
+ ps_text = (REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1").read_text(encoding="utf-8")
+
+ validate_set_match = re.search(r"\[ValidateSet\(([^)]*)\)\]", ps_text)
+ assert validate_set_match is not None
+ validate_set_values = re.findall(r"'([^']+)'", validate_set_match.group(1))
+
+ assert "kimi" in validate_set_values
+
+ def test_kimi_in_github_release_output(self):
+ """GitHub release script should include kimi template packages."""
+ gh_release_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-github-release.sh").read_text(encoding="utf-8")
+
+ assert "spec-kit-template-kimi-sh-" in gh_release_text
+ assert "spec-kit-template-kimi-ps-" in gh_release_text
+
+ def test_ai_help_includes_kimi(self):
+ """CLI help text for --ai should include kimi."""
+ assert "kimi" in AI_ASSISTANT_HELP
diff --git a/tests/test_ai_skills.py b/tests/test_ai_skills.py
index a040b4bd0..e9bd71d05 100644
--- a/tests/test_ai_skills.py
+++ b/tests/test_ai_skills.py
@@ -410,8 +410,11 @@ class TestInstallAiSkills:
skills_dir = _get_skills_dir(proj, agent_key)
assert skills_dir.exists()
skill_dirs = [d.name for d in skills_dir.iterdir() if d.is_dir()]
- assert "speckit-specify" in skill_dirs
- assert (skills_dir / "speckit-specify" / "SKILL.md").exists()
+ # Kimi uses dot-separator (speckit.specify) to match /skill:speckit.* invocation;
+ # all other agents use hyphen-separator (speckit-specify).
+ expected_skill_name = "speckit.specify" if agent_key == "kimi" else "speckit-specify"
+ assert expected_skill_name in skill_dirs
+ assert (skills_dir / expected_skill_name / "SKILL.md").exists()