get_skill

Look up a Bridge Town skill by exact name or natural-language query. Use when you know a skill name or need to find one from a description. Set include_template=true to get the full prompt template.

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
name	`Annotated[str	None, Field(default=None, description=“Exact skill name or slug (e.g. ‘gsheet-finance-styles’). Hyphen/underscore variants are treated as equivalent.”, max_length=_MAX_NAME_LEN)]`	No	None
query	`Annotated[str	None, Field(default=None, description=“Natural-language description of the skill you need (e.g. ‘format the P&L sheet with financial statement layouts’). Use when the exact skill name is unknown.”, max_length=_MAX_QUERY_LEN)]`	No	None
include_template	Annotated[bool, Field(default=False, description='Return the full Jinja2 prompt template body. Omit or set false for compact metadata only.')]	No	False
limit	Annotated[int, Field(default=3, ge=1, le=_MAX_LIMIT, description='Maximum number of alternate matches to return for query lookups. Ignored for exact name lookups.')]	No	3

Returns

Returns a structured object. Top-level fields:

• matched (boolean)
• name (string)
• title (string)
• description (string)
• resource_uri (string)
• confidence (string)
• related_tools (array<string>)
• category (string)
• required_context (array)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "get_skill",
  "arguments": {
    "name": "bridge-town-gsheet-formatting"
  }
}

Response

{
  "matched": true,
  "name": "bridge-town-gsheet-formatting",
  "title": "Bridge Town Gsheet Formatting",
  "description": "Use whenever a Bridge Town agent is about to write model output to Google Sheets.",
  "resource_uri": "skill://bridge-town-gsheet-formatting",
  "confidence": "exact",
  "related_tools": [
    "write_gsheet",
    "format_gsheet",
    "modify_gsheet_structure",
    "ingest_data_source"
  ],
  "category": "gsheet-formatting",
  "required_context": []
}

Notes

• Module: Skills
• Requires authentication via API token or Auth0 JWT.