github/spec-kit · error · ValueError

Integration key must be lowercase kebab-case, for example 'm

Error message

Integration key must be lowercase kebab-case, for example 'my-agent'.

What it means

Error "Integration key must be lowercase kebab-case, for example 'my-agent'." thrown in github/spec-kit.

Source

Thrown at src/specify_cli/integration_scaffold.py:72

    "skills": _IntegrationTemplate(
        base_class="SkillsIntegration",
        commands_subdir="skills",
        registrar_format="markdown",
        args="$ARGUMENTS",
        extension="/SKILL.md",
    ),
}


def supported_integration_scaffold_types() -> tuple[str, ...]:
    """Return supported scaffold template names."""
    return tuple(sorted(_TEMPLATES))


def _clean_key(key: str) -> str:
    clean = key.strip()
    if not _KEY_RE.fullmatch(clean):
        raise ValueError(
            "Integration key must be lowercase kebab-case, for example 'my-agent'."
        )
    return clean


def _package_name(key: str) -> str:
    return key.replace("-", "_")


def _class_name(key: str) -> str:
    return "".join(part.capitalize() for part in key.split("-")) + "Integration"


def _display_name(key: str) -> str:
    return " ".join(part.capitalize() for part in key.split("-"))


def _integration_content(

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Use a lowercase kebab-case integration key, e.g. 'my-agent'.

When it happens

Trigger: Thrown at src/specify_cli/integration_scaffold.py:72 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of github/spec-kit@bf88c9f9a8 (2026-08-14). Data as JSON: /api/errors/bf7156856777c8f7. Report an issue: GitHub.