platform-guide

OpenAkita Platform guide for searching and installing Agents from Agent Hub and Skills from Skill Store. Use when user asks to find, browse, or install Agents or Skills from the platform.

1,592 stars

Best use case

platform-guide is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

OpenAkita Platform guide for searching and installing Agents from Agent Hub and Skills from Skill Store. Use when user asks to find, browse, or install Agents or Skills from the platform.

Teams using platform-guide should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/platform-guide/SKILL.md --create-dirs "https://raw.githubusercontent.com/openakita/openakita/main/skills/system/platform-guide/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/platform-guide/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How platform-guide Compares

Feature / Agentplatform-guideStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

OpenAkita Platform guide for searching and installing Agents from Agent Hub and Skills from Skill Store. Use when user asks to find, browse, or install Agents or Skills from the platform.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# OpenAkita Platform Guide — AI 操作手册

> **核心原则**:当用户需要某种能力但本地没有时,你应该 **主动搜索平台**。

## 什么时候该用平台?

- 用户说"帮我找一个 XX Agent / 技能 / Skill"
- 用户需要某种能力但本地没有对应的技能
- 用户说"有没有现成的"、"市场上有吗"、"安装一个"
- 用户提到 Agent Hub、Skill Store、OpenAkita 平台

**注意**:平台是 **可选扩展**,离线时所有本地功能不受影响。

---

## Agent 安装三步走

当用户想从平台获取 Agent 时:

**第 1 步 — 搜索**
```
search_hub_agents(query="客服", category="customer_service")
```
- 查看返回的 Agent 列表,注意每个 Agent 的 `id`

**第 2 步 — 预览(推荐)**
```
get_hub_agent_detail(agent_id="the-agent-id")
```
- 查看描述、技能列表、评分、下载量

**第 3 步 — 安装**
```
install_hub_agent(agent_id="the-agent-id")
```
- 系统自动:下载包 → 解压技能 → 版本去重 → 注册 Agent → 热重载
- 安装后 Agent **立刻可用**

### 安装时发生了什么?
1. 下载 `.akita-agent` 包
2. 打包的技能 → `skills/custom/`(版本去重:本地有更新版就跳过)
3. 外部依赖技能 → 从原始 GitHub 仓库拉取到 `skills/community/`
4. 每个技能写入 `.openakita-origin.json` 追踪来源
5. Agent 配置注册到本地 → 技能自动重载

---

## Skill 安装三步走

当用户想从平台获取 Skill 时:

**第 1 步 — 搜索**
```
search_store_skills(query="翻译", trust_level="official")
```
- 注意 `trustLevel`:official(官方)> certified(认证)> community(社区)

**第 2 步 — 预览(推荐)**
```
get_store_skill_detail(skill_id="the-skill-id")
```
- 查看描述、开源协议、GitHub Stars、评分

**第 3 步 — 安装**
```
install_store_skill(skill_id="the-skill-id")
```
- 从原始 GitHub 仓库直接克隆(非平台重新分发)
- 安装后技能 **立刻可用**

---

## 本地 Agent 导入导出(不需要平台)

```
list_exportable_agents()                                    # 查看可导出的
export_agent(profile_id="my-agent", version="1.0.0")        # 导出
inspect_agent_package(package_path="xxx.akita-agent")       # 预览包
import_agent(package_path="xxx.akita-agent")                # 导入
```

---

## 版本去重策略

| 场景 | 行为 |
|------|------|
| 本地有同名 skill 且版本 >= 新包中的版本 | **跳过**(保留本地更新版) |
| 新包中版本 > 本地版本 | **覆盖**(升级到新版) |
| 任一方无版本信息 | **覆盖**(安全起见) |

---

## 平台离线时的替代方案

| 需求 | 替代方式 |
|------|----------|
| 找 Agent | 用 `.akita-agent` 文件导入 |
| 找 Skill | `install_skill` 从 GitHub 直接装;Setup Center 的 skills.sh 市场 |
| 共享 Agent | `export_agent` 导出文件分享 |

---

## 全部平台工具速查

| 工具 | 用途 |
|------|------|
| `search_hub_agents` | 搜索平台上的 Agent |
| `get_hub_agent_detail` | 查看 Agent 详情 |
| `install_hub_agent` | 安装 Agent 到本地 |
| `search_store_skills` | 搜索平台上的 Skill |
| `get_store_skill_detail` | 查看 Skill 详情 |
| `install_store_skill` | 安装 Skill 到本地 |
| `submit_skill_repo` | 提交 GitHub 仓库为新 Skill |
| `export_agent` | 导出本地 Agent |
| `import_agent` | 导入 Agent 包 |
| `list_exportable_agents` | 列出可导出的 Agent |
| `inspect_agent_package` | 预览 Agent 包内容 |

---

## 许可证合规

- 平台上的 Skill 从 **原始开源仓库** 拉取,非平台重新分发
- Agent 包可能含 `LICENSE-3RD-PARTY.md` 列出外部依赖
- 安装前应告知用户相关许可证
- 侵权联系:zacon365@gmail.com

Related Skills

obsidian-kb/ofm-guide

1592
from openakita/openakita

Guide for creating and editing Obsidian notes using Obsidian Flavored Markdown (OFM). Covers wikilinks, embeds, callouts, YAML properties, and knowledge organization best practices.

openakita/skills@yuque-skills

1592
from openakita/openakita

Manage Yuque (语雀) knowledge bases, documents, and team collaboration through API integration. Supports personal search, weekly reports, knowledge base management, document CRUD, and group collaboration workflows. Based on yuque/yuque-skills.

openakita/skills@youtube-summarizer

1592
from openakita/openakita

Summarize YouTube videos by extracting transcripts and generating structured notes. Use when the user wants to summarize a YouTube video, extract key points from a talk, create study notes from a lecture, or get timestamps for important moments. Supports multiple URL formats and languages.

openakita/skills@xlsx

1592
from openakita/openakita

Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.

openakita/skills@xiaohongshu-creator

1592
from openakita/openakita

Create engaging Xiaohongshu (RED/小红书) content including titles, body text, hashtags, and image style recommendations. Supports multiple content types such as product reviews, tutorials, lifestyle sharing, and shopping guides with platform-specific optimization.

openakita/skills@wechat-article

1592
from openakita/openakita

Create and format WeChat Official Account (公众号) articles with proper Markdown-to-WeChat HTML conversion, rich formatting, cover image guidance, and both API and manual publishing workflows.

openakita/skills@webapp-testing

1592
from openakita/openakita

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

openakita/skills@web-artifacts-builder

1592
from openakita/openakita

Suite of tools for creating elaborate, multi-component interactive HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.

openakita/skills@video-downloader

1592
from openakita/openakita

Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

openakita/skills@translate-pdf

1592
from openakita/openakita

Translate PDF documents while preserving original layout, styling, tables, images, and formatting. Supports Simplified Chinese, Traditional Chinese, English, Japanese, Korean, and more. Page-by-page translation with structure preservation.

openakita/skills@todoist-task

1592
from openakita/openakita

Manage Todoist tasks, projects, sections, labels, and filters via REST API v2. Supports task CRUD, due dates, priorities, recurring tasks, project organization, and advanced filtering. Based on doggy8088/agent-skills/todoist-api, using curl + jq.

openakita/skills@theme-factory

1592
from openakita/openakita

Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.