{
  "markdown": "# Starchild Official Skills\n\nOfficial skills maintained by the Starchild team. Installed via [`npx skills`](https://github.com/vercel-labs/skills).\n\n> **Building a new skill?** See **[CONTRIBUTING.md](CONTRIBUTING.md)** for the full guide — directory structure, `SKILL.md` frontmatter, `exports.py` patterns, function design best practices, logo specs, and a publishing checklist.\n\n## Install a Skill\n\n```bash\nnpx skills add Starchild-ai-agent/official-skills --skill hyperliquid\n```\n\nOr within a Starchild agent conversation:\n\n```\nsearch_skills(query=\"hyperliquid\")    # searches + auto-installs\n```\n\n## Repository Structure\n\n```\nofficial-skills/\n├── skills.json              ← auto-generated index (do not edit manually)\n├── .github/workflows/\n│   └── build-index.yml      ← CI: validates + rebuilds skills.json on push\n├── hyperliquid/\n│   └── SKILL.md\n├── birdeye/\n│   ├── SKILL.md\n│   ├── token.py             ← tool scripts (optional)\n│   └── templates/\n└── ...\n```\n\nEach skill lives in its own top-level directory. The only required file is `SKILL.md`.\n\n## SKILL.md Format\n\nEvery `SKILL.md` must have YAML frontmatter with three required fields:\n\n```yaml\n---\nname: my-skill\nversion: 1.0.0\ndescription: Short summary of what this skill does\n---\n\n# My Skill\n\nInstructions, usage examples, API references, etc.\n```\n\n### Required Fields\n\n| Field | Rules | Example |\n|-------|-------|---------|\n| `name` | Lowercase, alphanumeric + hyphens | `hyperliquid` |\n| `version` | Semver | `1.0.0` |\n| `description` | One-line summary for search | `Trade perpetual futures on Hyperliquid DEX` |\n\n### Optional Fields\n\n| Field | Purpose | Example |\n|-------|---------|---------|\n| `tools` | List of tool names this skill provides | `[hl_account, hl_order]` |\n| `metadata` | Starchild-specific metadata (emoji, skillKey) | `starchild: { emoji: \"📊\" }` |\n| `user-invocable` | Whether users can invoke this skill directly | `true` |\n| `tags` | Search tags | `[trading, defi]` |\n\n### Multi-File Skills\n\nSkills can include additional files (Python scripts, templates, configs). Place them alongside `SKILL.md` in the same directory:\n\n```\nbirdeye/\n├── SKILL.md\n├── __init__.py\n├── token.py\n├── wallet.py\n└── tools/\n```\n\n`npx skills add` copies the entire directory recursively.\n\n## Development Workflow\n\n> The quick steps below cover the basics. For the full guide — including `exports.py` patterns, function design principles (one-function-per-intent, read+execute pairing), logo sourcing, and a publishing checklist — see **[CONTRIBUTING.md](CONTRIBUTING.md)**.\n\n### Add a New Skill\n\n1. Create a directory:\n\n```bash\nmkdir my-new-skill\n```\n\n2. Write `SKILL.md` with the required frontmatter (name, version, description).\n\n3. Push to `main`:\n\n```bash\ngit add my-new-skill/\ngit commit -m \"feat: add my-new-skill\"\ngit push\n```\n\n4. GitHub Actions automatically validates the frontmatter and updates `skills.json`.\n\n### Update an Existing Skill\n\n1. Edit the skill files.\n\n2. **Bump the version** in the frontmatter:\n\n```yaml\nversion: 1.0.0  →  version: 1.1.0\n```\n\n3. Push. CI updates `skills.json` automatically.\n\n> Users who already installed the skill will get the new version on next `npx skills add` (npx detects the changed `computedHash`).\n\n### Remove a Skill\n\n1. Delete the directory:\n\n```bash\nrm -rf old-skill\ngit add -A && git commit -m \"chore: remove old-skill\" && git push\n```\n\n2. CI updates `skills.json` automatically (skill removed from index).\n\n3. To also remove from running user containers, add the skill name to `config/skill-removals.txt` in the [starchild-clawd](https://github.com/Starchild-ai-agent/starchild-clawd) repo.\n\n## CI Pipeline\n\nOn every push to `main` that touches `*/SKILL.md`:\n\n1. **Validate** — scans all `SKILL.md` files, fails if any are missing `name`, `version`, or `description`\n2. **Rebuild** — generates `skills.json` from frontmatter\n3. **Commit** — if `skills.json` changed, auto-commits and pushes\n\n> `skills.json` is auto-generated. Do not edit it manually — your changes will be overwritten.\n\n## Conventions\n\n- **Naming**: lowercase, hyphens only (e.g. `trading-strategy`, not `TradingStrategy`)\n- **Versioning**: semver — bump patch for fixes, minor for new features, major for breaking changes\n- **One skill per directory**: each directory = one installable unit\n- **Keep skills focused**: one skill = one integration or workflow (e.g. `hyperliquid`, not `all-exchanges`)\n- **Description matters**: it's the primary search field — make it specific and keyword-rich\n",
  "bytes": 4496,
  "sha": "415f73c0e4d2d14f18bdd2877b3bda906a42c8c56968f7bc28e10abf5554f333",
  "repo_slug": "starchild-ai-agent/official-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_starchild_ai_agent_official_skills_skill_8aa587df/readme"
}