Agent skill

Agnes Free Text

by kangarooking in kangarooking/agnes-free-model-skills

Call the free Agnes text model API for chat completions, streaming answers, coding help, tool-calling experiments, and OpenAI-compatible text generation.

MITAuto-check passedAI & LLM Engineering

Install Agnes Free Text

skills CLI
$ npx skills add kangarooking/agnes-free-model-skills --skill agnes-free-text -a claude-code

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

GitHub CLI
$ gh skill install kangarooking/agnes-free-model-skills agnes-free-text --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/kangarooking/agnes-free-model-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agnes-free-text .claude/skills/agnes-free-text && 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
agnes-free-text
GitHub stars
199
Token cost
~630 tokens
SKILL.md length
211 words
Files
4 (incl. scripts, references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Call the free Agnes text model API for chat completions, streaming answers, coding help, tool-calling experiments, and OpenAI-compatible text generation.

  • Works in 5 steps: Clarify whether the user wants a direct… → Use scripts/agnes_text.py for repeatable… → Keep the model fixed to agnes-2.0-flash… → …
  • The user asks for 免费文本
  • SKILL.md covers Credential Rule, Quick Start, Workflow and Notes, plus 1 more section
  • Runs Python scripts from its folder; calls python3; reaches apihub.agnes-ai.com; needs AGNES_API_KEY and AGNES_TOKEN

What it does

Agnes Free Text is an agent skill from kangarooking/agnes-free-model-skills. Call the free Agnes text model API for chat completions, streaming answers, coding help, tool-calling experiments, and OpenAI-compatible text generation. Use when the user asks for 免费文本, 免费的文本模型, free text API, Agnes text, Agnes-2.0-Flash, free LLM calls, or wants to use a free chat/completion model through an Agent skill.

Its SKILL.md is about 630 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/api.md` and `scripts/agnes_text.py`).

It sits in AI & LLM Engineering, covering LLM API integration and Structured output and tool calling. It works with OpenAI. The repository describes itself as: Agnes AI 免费文本、图片、视频模型的 Codex/Agent Skills. The licence is MIT.

When your agent uses it

  • The user asks for 免费文本
  • Agnes-2.0-Flash
  • Wants to use a free chat/completion model through an Agent skill

Example prompts

  • “/agnes-free-text”

Requirements

  • Python 3
  • A credential in AGNES_API_KEY
  • A credential in AGNES_TOKEN

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Clarify whether the user wants a direct answer, JSON-like structured output, coding help, or streaming output.
  2. Use scripts/agnes_text.py for repeatable calls. Prefer --dry-run first when parameters are complex.
  3. Keep the model fixed to agnes-2.0-flash unless the API docs are updated.
  4. For multi-turn context, pass repeated --message role:content values instead of flattening the conversation into one prompt.
  5. For tool calling, pass --tools-json as either an inline JSON array or a path to a JSON file.

What it can do on your machine

Read from SKILL.md and the folder at commit f5cb579. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • apihub.agnes-ai.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • AGNES_API_KEY
    • AGNES_TOKEN

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

Context cost

Agnes Free Text loads about 630 tokens when it runs, and up to ~1.4k if it reads all its reference files. Until then it costs about 85 tokens; SKILL.md has 211 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~85
When it runs · the whole SKILL.md, loaded when a task matches
~630
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.4k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from kangarooking/agnes-free-model-skills at commit f5cb579, republished under its MIT licence (© kangarooking). 211 words, ~630 tokens.

Download SKILL.mdSave it as .claude/skills/agnes-free-text/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
agnes-free-text
description
Call the free Agnes text model API for chat completions, streaming answers, coding help, tool-calling experiments, and OpenAI-compatible text generation. Use when the user asks for 免费文本, 免费的文本模型, free text API, Agnes text, Agnes-2.0-Flash, free LLM calls, or wants to use a free chat/completion model through an Agent skill.

Agnes Free Text

Use this skill to call Sapiens AI's Agnes-2.0-Flash text model through the Agnes API.

Credential Rule

Read the API key from the environment. Do not hardcode keys in prompts, scripts, skill files, commits, or shell history.

Preferred variable:

bash
export AGNES_API_KEY="..."

The helper also accepts AGNES_TOKEN as a fallback.

Quick Start

Run a normal chat completion:

bash
python3 scripts/agnes_text.py chat \
  --prompt "用三句话解释 Agent 为什么需要工具调用"

Use a system prompt and save the raw response JSON:

bash
python3 scripts/agnes_text.py chat \
  --system "You are a concise technical writer." \
  --prompt "Explain tool calling for a beginner." \
  --output-json ./outputs/agnes-free-text/response.json

Pass tool definitions from JSON:

bash
python3 scripts/agnes_text.py chat \
  --prompt "Decide whether a weather tool is needed." \
  --tools-json ./tools.json \
  --tool-choice auto

Validate the request shape without calling the API:

bash
python3 scripts/agnes_text.py chat \
  --prompt "Write a short product intro." \
  --max-tokens 300 \
  --dry-run

Workflow

  1. Clarify whether the user wants a direct answer, JSON-like structured output, coding help, or streaming output.
  2. Use scripts/agnes_text.py for repeatable calls. Prefer --dry-run first when parameters are complex.
  3. Keep the model fixed to agnes-2.0-flash unless the API docs are updated.
  4. For multi-turn context, pass repeated --message role:content values instead of flattening the conversation into one prompt.
  5. For tool calling, pass --tools-json as either an inline JSON array or a path to a JSON file.

Notes

  • Endpoint: POST https://apihub.agnes-ai.com/v1/chat/completions
  • Model: agnes-2.0-flash
  • Request shape is compatible with OpenAI Chat Completions.
  • Supported features include system prompts, multi-turn messages, streaming, tool definitions, and tool choice.
  • If the API returns an authorization error, check AGNES_API_KEY first.

Reference

Read references/api.md when you need endpoint details, response fields, tool-calling shape, or streaming examples.

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

Files

SKILL.md and 3 other files (scripts, references) in agnes-free-text of kangarooking/agnes-free-model-skills.

  • SKILL.md
  • agents/openai.yaml
  • references/api.md
  • scripts/agnes_text.py

Open the folder on GitHubat commit f5cb579

Compare with similar skills

Agnes Free Text 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.

Agnes Free Text compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agnes Free Text this skillkangarooking/agnes-free-model-skills199—~630Automated safety check: PassMIT
Instructor Structured LLM OutputsOrchestra-Research/AI-Research-SKILLs13k6 repos~4.2kAutomated safety check: PassMIT
Venice Chatveniceai/skills143—~5.9kAutomated safety check: PassMIT
Azure Openai To Responsesmicrosoft/ai-agents-for-beginners77k—~6kAutomated safety check: NotesMIT
Afmscouzi1966/maclocal-api346—~1.2kAutomated safety check: PassMIT
Azure Openai To Responsesmicrosoft/ai-agents-for-beginners77k—~6kAutomated safety check: NotesMIT

Similar skills

  • Instructor Structured LLM Outputs

    Orchestra-Research/AI-Research-SKILLs

    Shows how to pull validated, typed data out of LLM responses with Instructor and Pydantic models, including retries on failure and partial streaming.

    13k GitHub starsUsed in 6 repos~4.2k tokens
    AI & LLM EngineeringAuto-check passed
  • Venice Chat

    veniceai/skills

    Call POST /chat/completions on Venice. An agent skill from veniceai/skills.

    143 GitHub stars~5.9k tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check passed
  • Azure Openai To Responses

    microsoft/ai-agents-for-beginners

    Official

    Migrate Python apps from Azure OpenAI Chat Completions to the Responses API.

    77k GitHub stars~6k tokensUpdated 20 days ago
    AI & LLM EngineeringAuto-check: notes
  • Afm

    scouzi1966/maclocal-api

    Maintain and extend AFM (maclocal-api), a Swift OpenAI-compatible local LLM server and CLI for Apple Foundation Models, MLX models, API gateway proxying, and Vision OCR.

    346 GitHub stars~1.2k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Azure Openai To Responses

    microsoft/ai-agents-for-beginners

    Official

    Shift Python apps dem from Azure OpenAI Chat Completions go Responses API.

    77k GitHub stars~6k tokensUpdated 20 days ago
    AI & LLM EngineeringAuto-check: notes
  • Openai API

    coco-research/coco

    A skill your agent uses when implementing GPT chat, streaming, function calling, embeddings for RAG, images, audio or batch jobs, or troubleshooting 429 rate limits and API or TypeScript errors.

    503 GitHub stars~7.6k tokensUpdated today
    AI & LLM EngineeringAuto-check: notes

More from kangarooking/agnes-free-model-skills

  • Agnes Free Image

    kangarooking/agnes-free-model-skills

    Generate free images with Agnes Image 2.1 Flash through the Agnes API, including text-to-image, image-to-image, high-density visual prompts, URL results, and local downloads.

    199 GitHub stars~687 tokensUpdated 4 mo ago
    Auto-check passed
  • Agnes Free Video

    kangarooking/agnes-free-model-skills

    Create free Agnes video generation tasks and retrieve video results through Agnes-Video-V2.0, including text-to-video, image-to-video, multi-image video, keyframe animation, async polling, and video…

    199 GitHub stars~754 tokensUpdated 4 mo ago
    Auto-check passed

Works with

Questions about Agnes Free Text

What does Agnes Free Text do?

Call the free Agnes text model API for chat completions, streaming answers, coding help, tool-calling experiments, and OpenAI-compatible text generation. Agnes Free Text is an agent skill from kangarooking/agnes-free-model-skills. Call the free Agnes text model API for chat completions, streaming answers, coding help, tool-calling experiments, and OpenAI-compatible text generation.

When should I use Agnes Free Text?

Agnes Free Text fits situations like: the user asks for 免费文本; agnes-2.0-Flash; wants to use a free chat/completion model through an Agent skill.

How do I install Agnes Free Text in Claude Code?

Run `npx skills add kangarooking/agnes-free-model-skills --skill agnes-free-text -a claude-code`. Or copy the skill folder (agnes-free-text in kangarooking/agnes-free-model-skills) into .claude/skills/agnes-free-text in your project. Claude Code loads it when a task matches its description.

How do I install Agnes Free Text in Codex?

Run `npx skills add kangarooking/agnes-free-model-skills --skill agnes-free-text -a codex`. Or copy the skill folder (agnes-free-text in kangarooking/agnes-free-model-skills) into .agents/skills/agnes-free-text in your project. Codex loads it when a task matches its description.

Can I use Agnes Free Text 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 kangarooking/agnes-free-model-skills --skill agnes-free-text -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agnes-free-text, .gemini/skills/agnes-free-text, .github/skills/agnes-free-text and .opencode/skills/agnes-free-text in your project.

What does Agnes Free Text need to run?

Going by SKILL.md and its folder, Agnes Free Text needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named AGNES_API_KEY and AGNES_TOKEN. Our summary lists: Python 3; A credential in AGNES_API_KEY; A credential in AGNES_TOKEN.

Does Agnes Free Text access the network?

SKILL.md names 1 domain. In commands or code: apihub.agnes-ai.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Agnes Free Text 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Agnes Free Text use?

Agnes Free Text 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 Agnes Free Text use?

About 630 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 723 tokens, read only when the agent opens those files.

What are the alternatives to Agnes Free Text?

Skills that share tags, products or a category with Agnes Free Text: Instructor Structured LLM Outputs (Orchestra-Research/AI-Research-SKILLs, 13k stars), Venice Chat (veniceai/skills, 143 stars), Azure Openai To Responses (microsoft/ai-agents-for-beginners, 77k stars) and Afm (scouzi1966/maclocal-api, 346 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agnes Free Text?

kangarooking (a GitHub user) maintains it in kangarooking/agnes-free-model-skills, which has 199 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on June 1, 2026.

Source: kangarooking/agnes-free-model-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.