Skip to content

Add d1 agent skill guidance #137

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
iamleonie merged 4 commits into from
Nov 11, 2026
Merged

Add d1 agent skill guidance #137

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
12b82b4
docs: add d1 agent skill setup
vishnu-samavedula Oct 2, 2026
95390b4
Merge main and move agent skill guidance to hosted d1 docs
vishnu-samavedula Oct 20, 2026
6fd14b0
docs: address d1 agent skill review feedback
vishnu-samavedula Oct 20, 2026
e96efc4
Merge main and resolve SKILL.md conflict
vishnu-samavedula Nov 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
264 changes: 0 additions & 264 deletions .mintlify/skills/decision-model/SKILL.md
View file
Open in desktop

This file was deleted.

4 changes: 2 additions & 2 deletions guides/decision-model-guide.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,10 @@ If the answer is one of N known options, use a decision model. If the answer is

Install the relevant SDK and configure your client. The LLM examples use the OpenAI SDK, which works with any OpenAI-compatible endpoint. The decision model examples use the [TypeSafe SDK](https://pypi.org/project/typesafe-sdk/) to call the [d1 decision model](/lfm/models/decision-models) through the Liquid AI API. To get an API key, see [d1: Setup](/lfm/models/d1#setup).

For larger migrations, you can hand your coding agent Liquid's decision-model skill before it audits the codebase:
For larger migrations, use the [Liquid d1 agent skill](https://github.com/Liquid4All/liquid-d1-skills) to help your coding agent audit the codebase. Follow [Agent Skills](/lfm/models/d1#agent-skills) for installation instructions, then start a new agent session and try:

```text
Load https://docs.liquid.ai/.well-known/skills/decision-model/skill.md, then inspect this project for generated-text calls that are really bounded decisions. Recommend d1 replacements for classification, routing, scoring, reranking, and yes/no gates.
Use the Liquid d1 skill to inspect this project for generated-text calls that are really bounded decisions. Recommend d1 replacements for classification, routing, scoring, reranking, and yes/no gates.
```

<Tabs>
Expand Down
34 changes: 32 additions & 2 deletions lfm/models/d1.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -85,12 +85,42 @@ Install the SDK and create a client:
</Tab>
</Tabs>

You can also use the following prompt to give your agent to enable it to use Liquid AI's decision models.
## Agent Skills

The [Liquid d1 agent skill](https://github.com/Liquid4All/liquid-d1-skills) helps coding agents find opportunities for d1 and integrate it into an application. It can inspect an existing codebase, recommend structured replacements for prompt-and-parse LLM calls, and help design effective Choice, Score, and Noul questions.

Choose one installation method for the coding agent you use:

<Tabs>
<Tab title="Claude Code">
```bash
claude plugin marketplace add Liquid4All/liquid-d1-skills
claude plugin install liquid-d1@liquid-ai
```
</Tab>
<Tab title="Codex">
```bash
codex plugin marketplace add Liquid4All/liquid-d1-skills
codex plugin add liquid-d1@liquid-ai
```
</Tab>
<Tab title="Other agents">
```bash
npx skills add Liquid4All/liquid-d1-skills --skill liquid-d1
```

Choose your agent when prompted.
</Tab>
</Tabs>

After installation, start a new agent session and try:

```text
Load https://docs.liquid.ai/.well-known/skills/decision-model/skill.md, then inspect this project for generated-text calls that are really bounded decisions. Recommend d1 replacements for classification, routing, scoring, reranking, and yes/no gates.
Use the Liquid d1 skill to inspect this project for generated-text calls that are really bounded decisions. Recommend d1 replacements for classification, routing, scoring, reranking, and yes/no gates.
```

The skill includes API and SDK references, guidance for Liquid, Vercel AI Gateway, and OpenRouter, and a dependency-free script for testing requests. Keep `LIQUID_API_KEY` in your environment instead of including it in a prompt.

## Your First Call

A single API call contains the following fields:
Expand Down
Loading