Skills

One folder, one file

Your skills live in ~/.bytnode-ai/skills/, one folder each, with a SKILL.md inside. Anything else in the folder, an example CSV for instance, travels with it.

~/.bytnode-ai/skills/
  funding-analysis/
    SKILL.md
    example.csv

The file starts with a header, then the instructions in Markdown:

---
name: funding-analysis
description: Read a perpetual's funding and infer positioning — this line is what the agent reads to decide whether to open the skill
---

# Funding analysis

The instructions. What to do, in what order, what to avoid,
the shape of the expected answer.

Who sees them

• Every agent, whatever its model access. The list, name and description, is in its prompt at every turn; the body is loaded when needed.
• Agents by OpenRouter key read them in place, through the Skill tool.
• Agents by subscription get a copy in .agents/skills/ and .claude/skills/ of their working folder, where their own skill mechanisms find them. The copy is refreshed when you edit the file, and a skill you remove disappears from there too; what you wrote by hand in those folders is left alone.

Skills are also read from the agent’s working folder and from ~/.agents/skills.

The ones that ship

Each profession comes with its own skills, and all four share a common set: how to query BytNode, the shape of a financial answer, trade execution, trade review, and deep research. They are plain files under professions/, editable like yours.