starchild-ai-agent/official-skills

本页由 AI 翻译，技术细节请以原文为准。查看原文

29 stars 质量 57 趋势 31

星童官方技能

概览

官方技能由星子团队维护。通过npx技能安装。完整指南请参见——目录结构、前言 SKILL.md、exports.py 模式、功能设计最佳实践、标志规范以及出版清单。或者在星童特工的对话中：每个技能都存在自己的顶层目录。唯一需要的文件是 SKILL.md。每个 SKILL.md 必须有包含三个必填字段的 YAML 前页：技能可以包括额外的文件（Python脚本、模板、配置）。将它们与 SKILL.md 并列放在同一目录中： NPX 技能递归地将整个目录的副本加成。以下快速步骤涵盖了基础知识。完整指南——包括 exports.py 模式、功能设计原则（每个意图一功能、阅读+执行配对）、标志来源和发布检查表——请参见。

概述（AI 翻译）

官方技能由Starchild团队维护。通过npx skills安装。

建立新技能？ 完整指南请参见CONTRIBUTING.md ——目录结构、SKILL.md前言、exports.py模式、功能设计最佳实践、标志规范和发布清单。

安装一项技能

或者在星童特工的对话中：

仓库结构

每个技能都存在其顶层目录。唯一需要的文件是SKILL.md。

SKILL.md 节目形式

每个SKILL.md必须有带有三个必填字段的YAML前件：

必填字段

字段	规则	示例
`name`	小写字母，字母数字 + 连字符	`hyperliquid`
`version`	塞姆弗	`1.0.0`
`description`	搜索用一行摘要	`Trade perpetual futures on Hyperliquid DEX`

可选字段

场	目的	示例
`tools`	该技能提供的工具名称列表	`[hl_account, hl_order]`
`metadata`	星之子专属元数据（表情符号，技能键）	`starchild: { emoji: "📊" }`
`user-invocable`	用户是否能直接调用此技能	`true`

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Starchild Official Skills

Official skills maintained by the Starchild team. Installed via npx skills.

Building a new skill? See CONTRIBUTING.md for the full guide — directory structure, SKILL.md frontmatter, exports.py patterns, function design best practices, logo specs, and a publishing checklist.

Install a Skill

npx skills add Starchild-ai-agent/official-skills --skill hyperliquid

Or within a Starchild agent conversation:

search_skills(query="hyperliquid")    # searches + auto-installs

Repository Structure

official-skills/
├── skills.json              ← auto-generated index (do not edit manually)
├── .github/workflows/
│   └── build-index.yml      ← CI: validates + rebuilds skills.json on push
├── hyperliquid/
│   └── SKILL.md
├── birdeye/
│   ├── SKILL.md
│   ├── token.py             ← tool scripts (optional)
│   └── templates/
└── ...

Each skill lives in its own top-level directory. The only required file is SKILL.md.

SKILL.md Format

Every SKILL.md must have YAML frontmatter with three required fields:

---
name: my-skill
version: 1.0.0
description: Short summary of what this skill does
---

# My Skill

Instructions, usage examples, API references, etc.

Required Fields

Field	Rules	Example
`name`	Lowercase, alphanumeric + hyphens	`hyperliquid`
`version`	Semver	`1.0.0`
`description`	One-line summary for search	`Trade perpetual futures on Hyperliquid DEX`

Optional Fields

Field	Purpose	Example
`tools`	List of tool names this skill provides	`[hl_account, hl_order]`
`metadata`	Starchild-specific metadata (emoji, skillKey)	`starchild: { emoji: "📊" }`
`user-invocable`	Whether users can invoke this skill directly	`true`
`tags`	Search tags	`[trading, defi]`

Multi-File Skills

Skills can include additional files (Python scripts, templates, configs). Place them alongside SKILL.md in the same directory:

birdeye/
├── SKILL.md
├── __init__.py
├── token.py
├── wallet.py
└── tools/

npx skills add copies the entire directory recursively.

Development Workflow

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.

Add a New Skill

Create a directory:

mkdir my-new-skill

Write SKILL.md with the required frontmatter (name, version, description).
Push to main:

git add my-new-skill/
git commit -m "feat: add my-new-skill"
git push

GitHub Actions automatically validates the frontmatter and updates skills.json.

Update an Existing Skill

Edit the skill files.
Bump the version in the frontmatter:

在 GitHub 查看完整 README

安装

npx skillfish add starchild-ai-agent/official-skills

新手？先看 mcpskill.org 教程 →