Agent skill

Horse Minimal API

by HashLoad in HashLoad/horse

Guide for building lightweight, low-boilerplate, and rapid HTTP services (Minimal APIs) in Horse.

MITAuto-check passedDevelopment

Install Horse Minimal API

skills CLI
$ npx skills add HashLoad/horse --skill horse-minimal-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HashLoad/horse horse-minimal-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HashLoad/horse.git skills-src && mkdir -p .claude/skills && cp -r skills-src/doc/skills/horse-minimal-api .claude/skills/horse-minimal-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
horse-minimal-api
GitHub stars
1.4k
Token cost
~640 tokens
SKILL.md length
219 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Guide for building lightweight, low-boilerplate, and rapid HTTP services (Minimal APIs) in Horse.

  • Works in 3 steps: Single-File Bootstrap Design (Delphi) → Best Practices for Minimal APIs → When to Transition to MVC Architecture
  • Tasks that involve Project scaffolding
  • SKILL.md covers 1. Single-File Bootstrap…, 2. Best Practices for Minimal… and 3. When to Transition to MVC…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Horse Minimal API is an agent skill from HashLoad/horse. Guide for building lightweight, low-boilerplate, and rapid HTTP services (Minimal APIs) in Horse.

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Project scaffolding. The repository describes itself as: Fast, opinionated, minimalist web framework for Delphi. The licence is MIT.

When your agent uses it

  • Tasks that involve Project scaffolding

Example prompts

  • “/horse-minimal-api”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Single-File Bootstrap Design (Delphi)
  2. Best Practices for Minimal APIs
  3. When to Transition to MVC Architecture

What it can do on your machine

Read from SKILL.md and the folder at commit d4351a5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are pascal).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Horse Minimal API loads about 640 tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 219 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~29
When it runs · the whole SKILL.md, loaded when a task matches
~640

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HashLoad/horse at commit d4351a5, republished under its MIT licence (© HashLoad). 219 words, ~640 tokens.

Download SKILL.mdSave it as .claude/skills/horse-minimal-api/SKILL.md (or your agent's skills folder).
name
horse-minimal-api
description
Guide for building lightweight, low-boilerplate, and rapid HTTP services (Minimal APIs) in Horse.

Horse Minimal API

For focused microservices, mock APIs, or rapid prototyping, you can leverage Horse's lightweight routing and configuration DSL to build complete HTTP services in a single file with minimal boilerplate.


1. Single-File Bootstrap Design (Delphi)

A Minimal API structures all route registrations, basic logic, and middleware imports directly within the main .dpr bootstrap file using inline anonymous procedures:

pascal
program MinimalAPI;

{$APPTYPE CONSOLE}

uses
  System.SysUtils,
  System.JSON,
  Horse,
  Horse.Jhonson;

begin
  // 1. Fluent Middleware Configuration
  THorse.Use(Jhonson);

  // 2. Inline Route Mappings
  THorse.Get('/ping',
    procedure(Req: THorseRequest; Res: THorseResponse)
    begin
      Res.Send('pong');
    end);

  THorse.Get('/hello/:name',
    procedure(Req: THorseRequest; Res: THorseResponse)
    begin
      Res.Send('Hello, ' + Req.Params.Field('name').AsString + '!');
    end);

  // 3. Fast JSON response
  THorse.Get('/status',
    procedure(Req: THorseRequest; Res: THorseResponse)
    var
      LStatus: TJSONObject;
    begin
      LStatus := TJSONObject.Create(TJSONPair.Create('status', 'online'));
      Res.Send(LStatus); // Johnson takes ownership
    end);

  // 4. Port Listening
  THorse.Listen(9000);
end.

2. Best Practices for Minimal APIs

Although Minimal APIs promote rapid development, follow these principles to avoid "spaghetti code":

  1. Extract Complex Handlers: If a route handler exceeds 25 lines of code or requires database calls, do not write it inline. Extract it to a local unit procedure.
  2. Use Radix Router: Opt-in to THorse.UseRadixRouter; to ensure maximum matching speed if your API contains path parameters.
  3. Keep it Focused: A Minimal API should serve a single responsibility (Microservice). If you need to manage multiple domains (e.g. Users, Products, Invoices) in the same project, migrate to modular controllers.

3. When to Transition to MVC Architecture

Transition from a Minimal API to a structured MVC/Modular architecture when:

  • You start mixing database logic (queries) and HTML rendering/formatting inside the .dpr file.
  • Your project grows beyond 10 HTTP endpoints.
  • You need to reuse database layers across multiple CLI, daemon, or GUI applications.
  • You need to write structured unit/integration tests without bootstrap coupling.

© HashLoad, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in doc/skills/horse-minimal-api of HashLoad/horse.

Open the folder on GitHubat commit d4351a5

Compare with similar skills

Horse Minimal API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Horse Minimal API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Horse Minimal API this skillHashLoad/horse1.4k—~640Automated safety check: PassMIT
Template Devlbedner/aegis-stack143—~2.9kAutomated safety check: PassMIT
Portaljs Connect Ckandatopian/portaljs2.4k1 repos~1.5kAutomated safety check: PassMIT
Cabloy Backend Scaffoldcabloy/cabloy982—~3.1kAutomated safety check: PassMIT
Fe Tools Template RecommenderMichealWayne/fe-tools207—~1kAutomated safety check: PassNone
Create Datadriven Aspnetcoredotnet/skills5.6k1 repos~3.2kAutomated safety check: PassMIT

Similar skills

  • Template Dev

    lbedner/aegis-stack

    A skill your agent uses when developing or modifying Copier templates in aegis/templates, or backporting a change from a generated project (e.g.

    143 GitHub stars~2.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Portaljs Connect Ckan

    datopian/portaljs

    Wire a scaffolded PortalJS portal to a CKAN backend over its API.

    2.4k GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed
  • This skill should be used when the user needs the Vona backend scaffold/extend path in this Cabloy repo, especially to choose the right npm run vona generator or CRUD command and the required…

    982 GitHub stars~3.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Fe Tools Template Recommender

    MichealWayne/fe-tools

    Recommend the most suitable project template or initialization path from fe-tools project-templates based on product, framework, runtime, and delivery constraints.

    207 GitHub stars~1k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Official

    Generate or scaffold ASP.NET Core code — Razor Pages, Blazor components, MVC controllers, views, and Minimal API endpoints — without using ASP.NET Core CLI scaffolding/code-generation tools.

    5.6k GitHub starsUsed in 1 repo~3.2k tokens
    DevelopmentAuto-check passed
  • Corvus Ctj Handler Implementation

    corvus-dotnet/Corvus.JsonSchema

    Implement OpenAPI server handlers using Corvus.Text.Json generated types.

    199 GitHub stars~4.4k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from HashLoad/horse

All 23 skills in this repo
  • Horse App Structure

    HashLoad/horse

    Guide for setting up Horse applications, bootstrap program (.dpr), basic console initialization, and registering modules.

    1.4k GitHub stars~716 tokensUpdated 2 days ago
    Auto-check passed
  • Guide for setting up thread-safe database connection pooling (FireDAC / UniDAC) in multithreaded Horse applications.

    1.4k GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed
  • Guide for managing request-scoped contextual services and IoC (dependency injection) in Delphi and Lazarus.

    1.4k GitHub stars~985 tokensUpdated 2 days ago
    Auto-check passed
  • Horse Files Streams

    HashLoad/horse

    Guide to handling file uploads (multipart), downloads, and stream lifetime management in the Horse framework.

    1.4k GitHub stars~601 tokensUpdated 2 days ago
    Auto-check passed
  • Horse Grpc

    HashLoad/horse

    Guidelines and workflows for developing and maintaining gRPC services, HTTP/2 h2c transport, and Protobuf serialization within the Horse framework.

    1.4k GitHub stars~776 tokensUpdated 2 days ago
    Auto-check passed
  • Guide for writing automated integration tests for Horse endpoints using DUnit/DUnitX and THTTPClient.

    1.4k GitHub stars~964 tokensUpdated 2 days ago
    Auto-check passed

Questions about Horse Minimal API

What does Horse Minimal API do?

Guide for building lightweight, low-boilerplate, and rapid HTTP services (Minimal APIs) in Horse. Horse Minimal API is an agent skill from HashLoad/horse. Guide for building lightweight, low-boilerplate, and rapid HTTP services (Minimal APIs) in Horse.

When should I use Horse Minimal API?

Horse Minimal API fits situations like: tasks that involve Project scaffolding.

How do I install Horse Minimal API in Claude Code?

Run `npx skills add HashLoad/horse --skill horse-minimal-api -a claude-code`. Or copy the skill folder (doc/skills/horse-minimal-api in HashLoad/horse) into .claude/skills/horse-minimal-api in your project. Claude Code loads it when a task matches its description.

How do I install Horse Minimal API in Codex?

Run `npx skills add HashLoad/horse --skill horse-minimal-api -a codex`. Or copy the skill folder (doc/skills/horse-minimal-api in HashLoad/horse) into .agents/skills/horse-minimal-api in your project. Codex loads it when a task matches its description.

Can I use Horse Minimal API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HashLoad/horse --skill horse-minimal-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/horse-minimal-api, .gemini/skills/horse-minimal-api, .github/skills/horse-minimal-api and .opencode/skills/horse-minimal-api in your project.

What does Horse Minimal API need to run?

SKILL.md names no scripts, command-line tools or credentials: Horse Minimal API is instructions for the agent only.

Does Horse Minimal API access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Horse Minimal API safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Horse Minimal API use?

Horse Minimal API is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Horse Minimal API use?

About 640 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Horse Minimal API?

Skills that share tags, products or a category with Horse Minimal API: Template Dev (lbedner/aegis-stack, 143 stars), Portaljs Connect Ckan (datopian/portaljs, 2.4k stars), Cabloy Backend Scaffold (cabloy/cabloy, 982 stars) and Fe Tools Template Recommender (MichealWayne/fe-tools, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Horse Minimal API?

HashLoad (a GitHub organization) maintains it in HashLoad/horse, which has 1,377 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 7, 2026.

Source: HashLoad/horse on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.