Choose AI Model Skill Specification

Exact specification from Research decision 5.1 (Charter: Provider Independence).

Skill: Choose_AI_Model

A new skill Choose_AI_Model is created in Forge/Skills/.

Contents

1. Use Case Table — A table with three columns:

   • Use Case — pithy, memorable name for the task type
   • Recommended Model — the current model recommended for this use case
   • Notes — brief notes on why this model is recommended, any quirks

2. Model Reference Files — For each model that has quirks worth documenting, a reference file in the skill’s directory lists the model’s quirks. These files are the single source of truth for model-specific behavior.

Convention

In knowledge files and skills, refer to use case names (e.g., “the indexing use case”), not specific model names (e.g., “gpt-5.4-nano”). The Choose_AI_Model skill maps use case names to current models. When a model is swapped, only the skill’s table needs updating — all other docs remain valid because they reference the use case, not the model.

Affected Files

The following files currently hardcode model names and are updated to reference use case names instead:

• Forge/Skills/Forge_Optimizer/SKILL.md — defaults to glm-5.1 in project mode and gpt-5.4 in single-conversation mode
• Forge/Forge_Infrastructure.md — documents gpt-5.4-nano quirks as a section
• Forge/Skills/Reindex_Typesense/SKILL.md — documents gpt-5.4-nano indexing behavior
• Forge/Skills/Typesense_MCP/SKILL.md — references gpt-4o-mini for indexing and gpt-5.4-nano quirks

Model-specific quirk documentation is moved from inline skill procedures into the Choose_AI_Model skill’s model reference files.