AstrBot-Skill
Скилл и документация для плагинов AstrBot: API плагинов, события, сообщения, платформенные адаптеры и правила docs4agent
- 76 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Скилл только дает документацию и подсказки, ничего не запускает
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/astrbot-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл только дает документацию и подсказки, ничего не запускает
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AstrBot-Skill — репозиторий со скиллом `skill-astrbot-dev` и структурированной технической документацией по разработке плагинов AstrBot, фреймворка для чат-ботов. Загруженный скилл помогает агенту понять архитектуру плагинов и API, написать код плагина по принятым правилам и помочь с отладкой. Первая просьба из README: прочитать `skill-astrbot-dev/SKILL.md` и написать плагин, отвечающий «Привет!» на каждое сообщение. Документация разложена по разделам: стандарты проектирования с понятиями, архитектурой и лучшими практиками, система агентов с инструментами, субагентами, песочницей и задачами по расписанию, модели сообщений, событий и компонентов, настройка плагинов с декораторами, жизненным циклом и хуками, интерфейсы платформенных адаптеров, хранилище и утилиты. Второй скилл, `docs4agent`, задает правила писать документацию для агентов: убрать вежливые обороты и пояснения очевидного, сжать примеры API в однострочные блоки `python` и сделать структуру удобной для поиска имен методов, параметров и типов. Текст документации ведется на китайском с английской веткой `en/`.
Для кого. Разработчикам плагинов для AstrBot, которые пишут их с помощью ИИ-агента и хотят, чтобы он знал API и правила фреймворка.
Подходит, если
- Нужен плагин AstrBot, реагирующий на сообщение или команду с параметрами
- Нужно подключить платформенный адаптер и разобраться в его интерфейсе
- Агенту требуется точный справочник по событиям, цепочкам сообщений и хукам
- Плагину нужны постоянное хранилище, конфигурация и жизненный цикл
- Документацию по API хочется переписать в формате, удобном для агента
Не подходит, если
- Вы пишете не для AstrBot: скилл содержит только его документацию
- Нужна актуальная официальная документация: репозиторий лишь синхронизированный архив для изучения
- Нужен готовый плагин: в репозитории только справочник
Пример запроса к агенту
Прочитай skill-astrbot-dev и напиши плагин AstrBot, который на команду /hello с параметром отвечает приветствием по имени.Ограничения
Репозиторий назван синхронным архивом документации AstrBot и предназначен для изучения, файла лицензии в нем нет. Актуальные сведения лежат в официальной документации на `docs.astrbot.app` и в главном репозитории AstrBot, поэтому при расхождении верить стоит им. Основной текст на китайском, английская ветка `en/` неполная. Скилл сам AstrBot не запускает и подсказывает только код и структуру плагина. Установка идет через CLI skills.
Как отключить. Удалите скилл командой `npx skills remove` или удалите папку скилла из каталога скиллов агента. Сам AstrBot и ваши плагины это не затрагивает.
Частые вопросы
Как поставить скилл?
Командой `npx skills add xunxiing/AstrBot-Skill` для проекта или `npx skills add -g xunxiing/AstrBot-Skill` для всех проектов.
Что такое AstrBot?
Фреймворк для чат-ботов с системой плагинов и платформенными адаптерами. Документация проекта лежит на `docs.astrbot.app`.
Что описывает документация?
Стандарты проектирования, систему агентов, модели сообщений и событий, настройку плагинов с декораторами и хуками, платформенные адаптеры, хранилище и утилиты.
Для чего нужен docs4agent?
Он учит писать техдокументацию для агентов: без вежливых оборотов, с однострочными примерами `python` и структурой для быстрого поиска методов.
Заменяет ли репозиторий официальную документацию?
Нет. Это архив для изучения, а свежие сведения берут на `docs.astrbot.app` и из главного репозитория AstrBot.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Скиллыskill-creator — скиллы из OpenAPI, GraphQL и MCP
@asnd/skill-creator
Команда /skill-creator превращает ссылку на OpenAPI, GraphQL или MCP-сервер в готовый скилл с обертками и справочными файлами.
Библиотека из 30 с лишним скиллов-инструкций для кодинг-агентов: от плана и сборки до проверки, защиты от галлюцинаций и выкладки
Softaworks Agent Toolkit
Softaworks Agent Skills
Маркетплейс скиллов, субагентов и команд для кодовых агентов: разработка, документация, планирование и рабочая коммуникация
Builder Skills
Skills for agents
Набор небольших скиллов от Builder.io для рабочих привычек агента: визуальные планы и разборы диффов, сверка с документацией, кросс-агентное ревью и аккуратные
15 скиллов для Claude Code и Codex: Laravel, Docker, UI, отладка, тесты и документация в четырех готовых плагин-пакетах
Набор независимых скиллов против дрейфа в больших кодовых базах: hard-cut, поиск первопричины, тесты и проверка CI.
Коротко о README
Описаны назначение скилла, установка через skills CLI или скачиванием файла, структура документации, второй скилл docs4agent и ссылки на проект AstrBot.
Бейдж для README
Исходный SKILL.md
--- name: docs4agent description: 遵循极简主义、代码优先、AI 友好的技术文档写作规范。 --- # docs4agent (文档写作规范) 当需要为 AI Agent 编写或优化技术文档（尤其是 AstrBot 插件 API）时，使用此 Skill。目标是创建 100% 准确、无废话、机器易读的代码字典。 ## 写作核心原则 1. **极简主义**：删除所有客套话、目的说明、意义介绍和人类常识。 2. **代码优先**：将 API 示例压缩为单行代码块，并标注 `python` 语言标识。 3. **AI 友好**：使用结构化的标题和列表，确保 AI 能快速定位方法名、参数和类型。 4. **排除常识**：不需要解释“为什么要这样做”，只需告知“怎么做”。 5. 插件开发可直接调用,需要给出全部的插件可以使用的方法 6. 可以去参考sdk（例如astrbot sdk） ## 文档结构模版 ### 1. 标题与摘要 标题采用 `# 功能名`，摘要仅保留一行功能描述。 ### 2. API 调用区 使用 `###` 级标题区分方法，代码块必须单行化。 示例： `await manager.method_name(param1="value", param2=True)` ### 3. 维护/工具列表 使用无序列表描述辅助方法： - `method(id)`: 描述。 ### 4. 关键注意事项 (可选) 仅保留不符合常规逻辑或容易导致程序崩溃的底层细节（如 Handler 绑定丢失）。 ## 示例 (Cron API) # Cron #英文后面不需要加一个小括号解释中文 用于定时执行逻辑或唤醒 AI。AI 任务触发生成 `CronMessageEvent`。 ## 插件开发 API 通过 `self.context.cron_manager` 调用： ### 1. 注册 Python 函数 (Basic Job)