How to use Aheliotech Skills

Give your AI agents skills and knowledge — either paste once and forget, or give your AI a key and let it pull what it needs on demand.

Static — copy & paste
Open a skill, click Use, copy or download it, and drop it into your AI tool's settings. No API key needed.
Best when: you have one specific skill you want always active, or your tool doesn't support HTTP calls from within sessions.
Jump to

API & Bootstrap method

Give your AI a key once — it finds the right skill for every task
The library ships with a built-in skill — Helio Skills Library — API Guide — that teaches your AI how to browse, search, and load skills and knowledge from this library. Load it once and your AI handles the rest.
1
Generate an API key

In the library, click API Keys in the top bar. Give the key a label (e.g. cursor-dev), choose a scope (Skills, Knowledge, or both) and an access level (Read-only is enough for fetching), then click Generate key. Copy the key — it is only shown once.

Keys authenticate all /library/ endpoints via Authorization: Bearer <key>.

2
Fetch the guide skill

The built-in guide skill has the ID helio-skills-library-guide. Fetch it once:

curl -H "Authorization: Bearer <your-key>" \ https://skills.aheliotech.app/library/skills/helio-skills-library-guide

Copy the instructions field from the response. That text is your system prompt — it tells your AI the base URL, all available endpoints, how to search, and how to apply what it finds.

3
Give it to your AI tool as a system prompt or skill

Paste the instructions as a persistent system prompt, project instruction, or native skill — whichever your tool supports. See the per-tool sections below for exactly where. The key and the API base URL are embedded in the text.

Alternatively, use Use → Add to Claude (or the relevant tool button) directly from the skill detail view — it copies or downloads the skill in the right format for that tool.

4
Your AI can now load any skill on demand

In any conversation, the AI can call:

GET /library/skills?q=<topic> # search by keyword GET /library/skills?category=Planning # browse by category GET /library/skills/<id> # load a specific skill GET /library/categories # list all categories

It reads the returned instructions field and applies them to the task at hand — without you needing to manually copy or configure anything. You can tell it "use the best skill for writing an ITP spec" and it will search, find, and apply the right one.

5
Knowledge works the same way

If your API key has Knowledge scope, the AI can also retrieve reference documents:

GET /library/knowledge?q=<topic> GET /library/knowledge/<id> GET /library/knowledge-categories

Knowledge entries are factual reference material (configuration, architecture, conventions) rather than task instructions. The AI uses content from knowledge entries as background context.

6
Explore the full API spec

The library publishes an OpenAPI 3.1 spec — no auth required:

GET https://skills.aheliotech.app/openapi.json

Point any API-aware tool (Cursor, Copilot with extensions, custom agents) at this URL for auto-discovery of all endpoints, parameters, and response shapes.

Claude

claude.ai — native Skills, Projects, and API
Option A — Native Skills (recommended for claude.ai)
1
Enable Skills in Claude settings

Go to claude.aiSettings → Capabilities and turn on Code execution and File creation. Team/Enterprise admins enable this org-wide under Organization settings.

2
Add the API guide skill first

Open the Helio Skills Library — API Guide skill in this library, click Use → Add to Claude. A ZIP downloads and the how-to opens. Upload it via Customize → Skills → +. This gives Claude the ability to find and load any other skill itself.

3
Add individual skills the same way

For any other skill: click Use → Add to Claude (or Download .zip) then upload via Customize → Skills → +. The ZIP contains a SKILL.md in the exact format Claude expects. .zip

4
Invoke in any conversation

Skills are available in every chat. Claude activates one when context matches, or you can ask directly: "Use my <skill name> skill" or "Find and use the best skill for writing a test plan."

Option B — Project instructions
1
Create a Project

On claude.ai, click Projects → New project. Projects maintain context across conversations.

2
Paste skill instructions

Open a skill here and click Use → Copy as system prompt. In your Project, click Edit project details → Custom instructions and paste. All conversations in that project follow the skill.

Option C — Claude API / Claude Code
1
Load skill at runtime and inject as system prompt

Fetch the skill, then pass the instructions as the system parameter:

# Fetch skill SKILL=$(curl -s -H "Authorization: Bearer $API_KEY" \ https://skills.aheliotech.app/library/skills/my-skill \ | jq -r '.instructions') # Use with Claude API curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_KEY" \ -H "anthropic-version: 2023-06-01" \ -d "{\"model\":\"claude-opus-4-8\",\"max_tokens\":4096, \"system\":\"$SKILL\",\"messages\":[{\"role\":\"user\",\"content\":\"...\"}]}"
2
Claude Code — use CLAUDE.md or project settings

In your project root, paste skill instructions into CLAUDE.md. Claude Code reads this file automatically on every invocation. For team-shared instructions, commit CLAUDE.md to the repo.

Alternatively, add the guide skill as a slash command or MCP server that fetches skills from the library on demand.

GitHub Copilot

VS Code, JetBrains, github.com, CLI
Repo-wide instructions (applies to all Copilot features)
1
Export for VS Code / Copilot

Click Use → Export for VS Code. This downloads copilot-instructions.md — Copilot's native instructions format. copilot-instructions.md

2
Place in .github/

Move the file to .github/copilot-instructions.md in your repo root. Commit and push. Copilot picks it up automatically in VS Code, github.com, and the CLI — no extension settings needed.

3
Combine multiple skills

The file accepts any markdown. You can concatenate several skills' instructions into a single copilot-instructions.md — separate each with a heading so Copilot knows where one ends and another begins.

Prompt files (per-task, on demand)
1
Download as .prompt.md

Click Use → Download .md. Rename the file to <skill-name>.prompt.md and place it in .github/prompts/ in your repo. .prompt.md

2
Reference in chat

In Copilot Chat, type /<skill-name> to attach and invoke the prompt file. This keeps skills discoverable in the IDE without polluting repo-wide instructions.

Cursor

AI code editor — cursor.com
Project rules (persistent, per-repo)
1
Export for Cursor

Click Use → Export for Cursor. Downloads a .cursorrules file containing the skill instructions. .cursorrules

2
Place in project root or rules directory

For a single skill, rename the file to .cursorrules and place it in the project root. Cursor auto-discovers it. For multiple skills, place individual .mdc files in .cursor/rules/ — each file becomes a separate rule Cursor can selectively apply.

3
Enable the API guide for on-demand skill lookup

Add the API guide skill to your rules directory. Cursor Agent mode can then call the library API to pull the right skill for any task. In chat, tell Cursor: "Before starting, check the skills library for a relevant skill."

Global rules (applies to all projects)
1
Add to Cursor settings

Open Cursor Settings → Rules for AI and paste the skill instructions there. These apply across all projects — good for general coding standards you always want active.

Windsurf

AI code editor — codeium.com/windsurf
1
Export for Windsurf

Click Use → Export for Windsurf. Downloads a .windsurfrules file. .windsurfrules

2
Place in your project root

Rename the file to .windsurfrules and place it in the root of your project. Windsurf reads it automatically and applies the instructions to Cascade and inline completions.

3
Global rules

For rules that apply everywhere, open Windsurf Settings → Cascade → Global Rules and paste the skill instructions there.

VS Code

GitHub Copilot Chat & inline completions
1
Export for VS Code

Click Use → Export for VS Code. Downloads copilot-instructions.md in the format GitHub Copilot reads natively. copilot-instructions.md

2
Place in .github/

Put the file at .github/copilot-instructions.md in your project. VS Code's Copilot extension picks it up with no configuration. This shapes both inline suggestions and Copilot Chat for that workspace.

3
User-level instructions (global)

For instructions that follow you across all projects: open VS Code Settings → search "Copilot instructions" and paste the skill text into the GitHub Copilot: Instructions field.

Warp

AI terminal — warp.dev
1
Export for Warp

Click Use → Export for Warp to download a .yaml prompt file. .yaml

2
Place in your Warp prompts directory

Move the file to ~/.warp/prompts/ (create the directory if needed). Warp scans this folder automatically.

3
Invoke in Warp AI

Press the Warp AI shortcut, then browse your saved prompts. Select the skill to load its instructions as the session context. You can also reference it inline while typing a command.

4
Warp AI rules (persistent)

For instructions that are always active, open Warp Settings → AI → Custom instructions and paste the skill text. These apply to every Warp AI session.

Amazon Q Developer

VS Code & JetBrains extension, AWS console
1
Export for Amazon Q

Click Use → Export for Amazon Q. Downloads a Markdown file formatted for Q's rules system. .md

2
Place in .amazonq/rules/

Create the directory .amazonq/rules/ in your project root if it does not exist. Place the skill file there. Amazon Q Developer reads all files in this directory and applies them as context for that workspace.

3
Multiple rules

You can add multiple files to .amazonq/rules/ — each one is a separate context source. Name them descriptively (e.g. code-review.md, spec-writing.md) so Q can pick the most relevant one.

OpenAI / ChatGPT

ChatGPT, Custom GPTs, Assistants API, Responses API
Custom GPT
1
Copy as system prompt

Click Use → Copy as system prompt or Add to OpenAI. The full skill is now in your clipboard.

2
Create or edit a Custom GPT

Go to chatgpt.comExplore GPTs → Create (or edit an existing one). Paste the skill into the Instructions field. Users of that GPT will always have the skill active.

ChatGPT — temporary context
1
Paste at the start of a chat

Copy the skill instructions and paste them as the first message in a new conversation. Tell ChatGPT: "These are your instructions for this session. Acknowledge and wait for my first task."

Assistants API / Responses API
1
Inject skill as system instructions

Fetch the skill at runtime and pass instructions as the assistant's instructions field (Assistants API) or as the first system message in the input array (Responses API). Combine with knowledge entries for richer context.

# Fetch skill and knowledge, combine SKILL=$(curl -s -H "Authorization: Bearer $HELIO_KEY" \ https://skills.aheliotech.app/library/skills/my-skill | jq -r '.instructions') KNOW=$(curl -s -H "Authorization: Bearer $HELIO_KEY" \ https://skills.aheliotech.app/library/knowledge/platform-overview | jq -r '.content') SYSTEM="$SKILL ## Background Knowledge $KNOW"

Gemini

Google AI Studio, Gemini app, Gemini API
Gemini app / Gems
1
Copy for Gemini

Click Use → Gemini. The skill instructions are copied to your clipboard.

2
Create a Gem

On gemini.google.com, open Gem manager → New Gem. Paste the skill instructions into the Instructions field. Save and use the Gem for tasks that skill covers.

3
Or paste into a conversation

For a one-off use, start a new Gemini chat, paste the skill instructions, and say: "These are your working instructions. Ready for my first task."

Google AI Studio
1
Add as System Instructions

In AI Studio, open a prompt, expand System instructions, and paste the skill text. Save as a preset to reuse across sessions.

Gemini API
1
Pass skill as system_instruction

Fetch the skill at request time and set it as system_instruction in your GenerateContentRequest:

SKILL=$(curl -s -H "Authorization: Bearer $HELIO_KEY" \ https://skills.aheliotech.app/library/skills/my-skill | jq -r '.instructions') # Python SDK model = genai.GenerativeModel( model_name="gemini-2.0-flash", system_instruction=skill_text )