majiayu000 Skill Creator
Setup
Read your credentials from ~/.gooseworks/credentials.json:
export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")
If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login
All endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY"
Create modular, self-contained skill packages that extend agent capabilities.
Core Principle: Concise is Key
The context window is shared. Only add what the agent doesn't already know. Challenge every paragraph: "Does this justify its token cost?" Prefer concise examples over verbose explanations.
Skill Structure
skill-name/
├── SKILL.md # Required: frontmatter + instructions
├── scripts/ # Optional: executable code (deterministic tasks)
├── references/ # Optional: docs loaded on-demand
└── assets/ # Optional: files used in output (templates, images)
SKILL.md Format
---
name: skill-name
description: What it does + when to use it. This is the trigger mechanism.
---
# Skill Name
[Instructions for using the skill]
Frontmatter Rules
name: lowercase, hyphens, under 64 chars (e.g.,pdf-editor,gh-review-pr)description: Include BOTH what it does AND when to trigger. The body isn't loaded until after triggering, so all "when to use" info must be here.
Degrees of Freedom
Match specificity to task fragility:
| Freedom | Use When | Format |
|---|---|---|
| High | Multiple valid approaches | Text instructions |
| Medium | Preferred pattern exists | Pseudocode, parameterized scripts |
| Low | Fragile/error-prone ops | Specific scripts, few params |
Creation Process
- Understand - Gather concrete usage examples
- Plan - Identify reusable scripts, references, assets
- Initialize - Run
orth skills init <name> - Implement - Write SKILL.md, add resources
- Submit - Run
orth skills submit <path> - Iterate - Test on real tasks, refine
Quick Start
# Create new skill
orth skills init my-skill
# Or with path
orth skills init my-skill --path ~/.openclaw/skills
# Submit to Orthogonal
orth skills submit ./my-skill
# Update existing skill
orth skills update <slug> ./my-skill
What NOT to Include
- README.md, CHANGELOG.md, INSTALLATION_GUIDE.md
- Setup/testing procedures
- User-facing documentation
- Anything not needed for the agent to do the job
Progressive Disclosure
Keep SKILL.md under 500 lines. Split into reference files when approaching this limit.
Pattern: High-level guide with references
## Quick start
[Core workflow here]
## Advanced
- **Complex feature**: See references/feature.md
- **API details**: See references/api.md
Pattern: Domain organization
bigquery-skill/
├── SKILL.md (overview + navigation)
└── references/
├── finance.md
├── sales.md
└── product.md
Agent loads only the relevant reference file.