wick: Skill for Claude Code

Config Tag Reference

Every exported field in a Config / Configs struct that carries a wick:"..." tag becomes one editable row in the configs table at boot time, scoped to that module's key. Fields without a tag are ignored.

Tag grammar

Tags are semicolon-separated. A key=value pair sets a named attribute; a bare key is a boolean flag.

Never put a ; inside desc= prose. The separator is applied before anything looks at which key it is, so a semicolon in the description text ends the description there — the rest of your sentence silently disappears from the admin UI and from the connector schema the model reads. Nothing errors, and the tag still looks fine in the source. Worse, if the leftover fragment happens to read like an option (checkbox=true/false, date="YYYY-MM-DD") it is parsed as that option and switches on a widget you never asked for. Use a comma instead. TestWickTagDescriptionsAreNotSplitByProse in pkg/entity fails the build on a new one, naming the file, the line, and the text that would be dropped.

type Config struct {
    // text input + description
    Title string `wick:"desc=Card title shown in the UI."`

    // url widget + required + description
    Endpoint string `wick:"url;required;desc=API base URL. Example: https://api.example.com"`

    // dropdown with fixed options
    Mode string `wick:"desc=Conversion mode.;dropdown=uppercase|lowercase|titlecase"`

    // multi-line textarea
    Template string `wick:"desc=Prompt template.;textarea"`

    // number input (also auto-applied for int/float fields)
    MaxRows int `wick:"desc=Max rows returned per query.;required"`

    // secret/password field
    APIKey string `wick:"desc=External API key.;secret;required"`

    // native checkbox (auto-applied for bool fields)
    EnableCache bool `wick:"desc=Cache results across requests."`

    // toggle switch — clearer on/off visual; opt-in via `bool` flag
    DebugMode bool `wick:"bool;desc=Verbose logging."`

    // editable table — see kvlist section below
    Groups string `wick:"kvlist=id|name;desc=Visible group definitions."`

    // override the auto snake_case column name
    LegacyKey string `wick:"key=legacy_api_key;secret;desc=Deprecated. Kept for v1 clients."`
}