Configuring Horizon
coollabsio/coolify
A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.
使用 NcatBot 框架开发 QQ 机器人或跨平台 Bot。当用户需要快速体验、创建插件、注册事件处理、发送消息、调用 Bot API、使用 Mixin/Hook、使用 CLI 工具、编写插件测试、或调试运行问题时触发此技能。Use when: 开发…
$ npx skills add ncatbot/NcatBot --skill framework-usage -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ncatbot/NcatBot framework-usage --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/ncatbot/NcatBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/framework-usage .claude/skills/framework-usage && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "framework-usage" agent skill from https://github.com/ncatbot/NcatBot/tree/main/.agents/skills/framework-usage into .claude/skills/framework-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "framework-usage", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/ncatbot/NcatBot/tree/main/.agents/skills/framework-usageType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add ncatbot/NcatBot --skill framework-usage -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ncatbot/NcatBot framework-usage --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ncatbot/NcatBot.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/framework-usage .agents/skills/framework-usage && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "framework-usage" agent skill from https://github.com/ncatbot/NcatBot/tree/main/.agents/skills/framework-usage into .agents/skills/framework-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "framework-usage", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ncatbot/NcatBot --skill framework-usage -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ncatbot/NcatBot framework-usage --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ncatbot/NcatBot.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/framework-usage .cursor/skills/framework-usage && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "framework-usage" agent skill from https://github.com/ncatbot/NcatBot/tree/main/.agents/skills/framework-usage into .cursor/skills/framework-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "framework-usage", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/ncatbot/NcatBot.git --path .agents/skills/framework-usage--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add ncatbot/NcatBot --skill framework-usage -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ncatbot/NcatBot framework-usage --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ncatbot/NcatBot.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/framework-usage .gemini/skills/framework-usage && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "framework-usage" agent skill from https://github.com/ncatbot/NcatBot/tree/main/.agents/skills/framework-usage into .gemini/skills/framework-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "framework-usage", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install ncatbot/NcatBot framework-usageInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add ncatbot/NcatBot --skill framework-usage -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ncatbot/NcatBot.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/framework-usage .github/skills/framework-usage && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "framework-usage" agent skill from https://github.com/ncatbot/NcatBot/tree/main/.agents/skills/framework-usage into .github/skills/framework-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "framework-usage", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ncatbot/NcatBot --skill framework-usage -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ncatbot/NcatBot framework-usage --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ncatbot/NcatBot.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/framework-usage .opencode/skills/framework-usage && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "framework-usage" agent skill from https://github.com/ncatbot/NcatBot/tree/main/.agents/skills/framework-usage into .opencode/skills/framework-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "framework-usage", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
framework-usage使用 NcatBot 框架开发 QQ 机器人或跨平台 Bot。当用户需要快速体验、创建插件、注册事件处理、发送消息、调用 Bot API、使用 Mixin/Hook、使用 CLI 工具、编写插件测试、或调试运行问题时触发此技能。Use when: 开发…
Framework Usage is an agent skill from ncatbot/NcatBot. 使用 NcatBot 框架开发 QQ 机器人或跨平台 Bot。当用户需要快速体验、创建插件、注册事件处理、发送消息、调用 Bot API、使用 Mixin/Hook、使用 CLI 工具、编写插件测试、或调试运行问题时触发此技能。Use when: 开发 bot、写插件、发消息、消息段、群管理、事件处理、响应命令、Mixin、Hook、定时任务、权限、RBAC、CLI、调试、插件测试、多平台、跨平台、platform。
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `references/bot-api.md`, `references/events.md` and `references/getting-started.md`).
It sits in Backend & APIs, covering Authorization and RBAC. The repository describes itself as: NapCat Python SDK;快速开发你的 QQ 机器人. The licence is MIT.
6 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit c26300a. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Framework Usage loads about 1.2k tokens when it runs, and up to ~26k if it reads all its reference files. Until then it costs about 57 tokens; SKILL.md has 292 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from ncatbot/NcatBot at commit c26300a, republished under its MIT licence (© ncatbot). 292 words, ~1,245 tokens.
.claude/skills/framework-usage/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.你是 NcatBot 开发助手。帮助用户使用 NcatBot 框架开发 QQ 机器人或跨平台 Bot。
| 需要做什么 | 委托给 |
|---|---|
| 编写/运行/调试测试 | testing-framework |
| 定位框架内部代码、理解模块实现 | codebase-nav |
| 修框架 bug、改框架代码 | framework-dev |
| 用框架开发 bot | framework-usage(本技能) |
Phase 1: 需求理解 → Phase 2: 功能预览与确认 → Phase 3: 深入实现 → Phase 4: 验证接收用户自然语言需求后:
粗读 references/ — 快速匹配需求涉及的框架功能模块(见下方 §功能参考索引)。
框架选型由你决定 — 插件/非插件模式、Mixin 选择、Hook vs 装饰器、多平台 vs 单平台等框架内部决策,根据下表自行判断,不问用户。
| 场景 | 推荐模式 | 理由 |
|---|---|---|
| 快速验证想法、体验框架 | 非插件模式 | 零配置,全写在 main.py |
| 简单 Bot、几个命令 | 非插件模式 | 最小代码量 |
| 需要持久化配置/数据 | 插件模式 | ConfigMixin / DataMixin |
| 需要定时任务、权限控制 | 插件模式 | TimeTaskMixin / RBACMixin |
| 多功能、可维护的正式项目 | 插件模式 | 热重载 + Mixin + 结构化 |
仅外部依赖问用户 — 当需求涉及第三方 API/服务(天气、翻译、AI、数据源等)时,用 vscode_askQuestions 确认具体用哪个。精简,不刷屏。
规则:每个选项必须包含一个 "我不知道,你帮我选一个" 选项(标记
recommended: true)。
将用户需求拆分为独立功能点,为每个功能编写端到端对话流预览。
预览格式(每个功能点):
### 功能 N:<功能名>
<一句话描述>
**触发方式**:<用户输入的命令 / 外部事件>
**对话流**:
用户: <输入>
Bot: <输出>
用户: <输入>
Bot: <输出>
...完整格式规范和 4-5 个端到端预览样板见 preview-workflow.md。
预览交付方式:
PREVIEW.md,写入全部功能预览。逐功能确认:
用 vscode_askQuestions 逐功能确认(选项见 preview-workflow.md §功能确认模板):
若选"需要调整" → 修改预览后重新确认。循环直到全部功能通过。
全部功能预览确认后:
搭建项目、启动方式、CLI 命令详见 getting-started.md(含工作区检测、config 模板、NapCat 自动安装说明)。
根据用户需求查阅对应 reference:
| 用户需求 | 框架功能 | 参考 |
|---|---|---|
| 安装/搭建项目/CLI/配置 | 项目初始化 | getting-started.md |
| 响应命令/消息/事件 | 装饰器 + handler | events.md |
| 简单命令处理 | CommandHook(单层命令) | hooks.md |
| 分层命令结构(子命令/命令组) | CommandGroupHook | hooks.md |
| 过滤/拦截/中间件 | Hook 系统 | hooks.md |
| 发送文字/图片/视频/转发 | 消息构造与发送 | messaging.md |
| 群管理/查询信息/文件/平台 API | Bot API | bot-api.md |
| HTTP 下载/请求/代理检查 | MiscAPI (api.misc) | bot-api.md |
| 持久化配置/数据 | ConfigMixin / DataMixin | mixins.md |
| 定时任务/权限控制/事件流 | TimeTaskMixin / RBACMixin / EventMixin | mixins.md |
| 多步对话/等待回复 | wait_event / EventStream | events.md |
| 非阻塞启动/事件编排 | run_async + wait_event + events() | events.md |
| 多平台/跨平台/Trait | BotAPIClient 多平台门面, Trait 协议 | multi-platform.md |
| 平台登录/适配器配置 | 各适配器登录流程 | multi-platform.md |
| 插件结构/生命周期 | manifest + 基类 | plugin-structure.md |
内置 ! 管理命令(热重载/sysinfo/开关) | _system_manager + plugin.* 配置 | docs/docs/notes/guide/3. 插件开发/12. 内置管理命令.md |
| 调试/排错/日志 | 诊断与排查 | troubleshooting.md |
| 功能预览格式与样板 | 端到端预览流程 | preview-workflow.md |
references/ 是常用 API 和模式的速查,覆盖搭建、事件、Hook、消息、API、Mixin、多平台、插件结构、排错、功能预览。在 Phase 1 阶段快速匹配功能模块即可。
全部功能预览确认后,在 Phase 3 仔细阅读对应文档:
docs/docs/notes/guide/README.md — 全局入口,含 Quick Start 和指南索引| 关键词 | 直接查阅 |
|---|---|
| 快速开始/安装 | docs/docs/notes/guide/1. 快速开始/ |
| 适配器/平台登录 | docs/docs/notes/guide/2. 适配器/ |
| 插件/事件/Hook/生命周期 | docs/docs/notes/guide/3. 插件开发/ |
| 消息段/转发 | docs/docs/notes/guide/4. 消息发送/ |
| Bot API/群管理 | docs/docs/notes/guide/5. API 使用/ |
| 配置 | docs/docs/notes/guide/6. 配置管理/ |
| RBAC/权限 | docs/docs/notes/guide/7. RBAC 权限/ |
| CLI | docs/docs/notes/guide/8. 命令行工具/ |
| 测试 | docs/docs/notes/guide/9. 测试指南/ |
| 多平台 | docs/docs/notes/guide/10. 多平台开发/ |
| 架构/概念 | docs/docs/notes/guide/11. 架构与概念/ |
docs/docs/notes/reference/ — API 签名完整参考(10 个模块)docs/docs/README.md — 文档全局目录树当需要理解框架内部实现(而非使用层面),使用 codebase-nav 技能。
© ncatbot, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 10 other files (references) in .agents/skills/framework-usage of ncatbot/NcatBot.
Open the folder on GitHubat commit c26300a
Framework Usage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Framework Usage this skillncatbot/NcatBot | 116 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Configuring Horizoncoollabsio/coolify | 63k | 4 repos | ~898 | Automated safety check: Pass | MIT | |
| K8s Security PoliciesCybereason-Public/owLSM | 280 | 12 repos | ~2k | Automated safety check: Pass | GPL-2.0 | |
| Payloadpayloadcms/payload | 45k | 5 repos | ~6.2k | Automated safety check: Pass | MIT | |
| Convex Setup Authspokvulcan/poker-planning | 114 | 8 repos | ~1.8k | Automated safety check: Pass | MIT | |
| Abp Authorizationabpframework/abp | 14k | — | ~1.3k | Automated safety check: Pass | LGPL-3.0 |
coollabsio/coolify
A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.
Cybereason-Public/owLSM
Comprehensive guide for implementing NetworkPolicy, PodSecurityPolicy, RBAC, and Pod Security Standards in Kubernetes.
payloadcms/payload
A skill your agent uses when working with Payload projects (payload.config.ts, collections, fields, hooks, access control, Payload API).
spokvulcan/poker-planning
Sets up Convex auth, identity mapping, and access control. An agent skill from spokvulcan/poker-planning.
abpframework/abp
ABP permission system - PermissionDefinitionProvider, [Authorize] attribute, CheckPolicyAsync, IsGrantedAsync, ICurrentUser, IPermissionManager, multi-tenancy side.
bagofwords1/bagofwords
Exhaustively audit the UI control by control and role by role — enumerate every button, link, and input on a set of pages, write down what each is supposed to do (derived from the handler code and…
ncatbot/NcatBot
定位 NcatBot 代码实现:锁定模块目录、找到关键类/函数、追踪调用链。当文档不够时才读代码,用搜索而非遍历。Use when: 找代码实现、哪个文件、哪个类、追踪调用链、定位 bug 行号、代码在哪、模块目录、源码定位。
ncatbot/NcatBot
维护 NcatBot 项目文档、示例、Skills 知识资产。编写/编辑文档、修复文档问题、文档结构规范审查。Use when: 写文档、改文档、新增文档、修复断链、修复索引、修复代码块标注、文档规范、文档模板、文档结构设计、docs maintenance。
ncatbot/NcatBot
整体/局部防腐检查:Docs 内部链接断裂、README 索引不同步、guide↔reference 内容不一致、examples 导入过时、Code↔Docs API 对齐。逐文件检查,最大化并发 subagent。Use when: docs 防腐、docs 链接、docs 断链、断链检查、docs 审计、docs audit、code docs 对齐、reference 过时、guide…
ncatbot/NcatBot
将 NcatBot 4.4/4.5 版本插件迁移到 5.0。包括导入路径、注册方式、Config/Data API、事件类型、消息构造的全面映射。Use when: 迁移插件、升级插件、4 转 5、老版本、旧版本、migration、upgrade、plugin migration、版本升级。
ncatbot/NcatBot
发布 NcatBot 新版本到 PyPI 和 GitHub Release,或仅编排 Commit 推送到 main。从工作区变更编排 commit 到最终发布的全链路流程。Use when: 发版、release、发布、changelog、版本号、pick commits、挑选提交、release notes、编排 commit、push、推送。
ncatbot/NcatBot
检查、报告、修复 Skills 间链接内容不同步,以及 Skills↔Docs 内容链接不同步。逐文件检查,最大化并发 subagent。Use when: skill 同步、skill 断链、skill 引用、skill 过时、skill audit、skills 一致性、skill 检查、skill↔docs。
Categories
使用 NcatBot 框架开发 QQ 机器人或跨平台 Bot。当用户需要快速体验、创建插件、注册事件处理、发送消息、调用 Bot API、使用 Mixin/Hook、使用 CLI 工具、编写插件测试、或调试运行问题时触发此技能。Use when: 开发…. Framework Usage is an agent skill from ncatbot/NcatBot.
Framework Usage fits situations like: : 开发 bot、写插件、发消息、消息段、群管理、事件处理、响应命令、Mixin、Hook、定时任务、权限、RBAC、CLI、调试、插件测试、多平台、跨平台、platform; tasks that involve Authorization and RBAC.
Run `npx skills add ncatbot/NcatBot --skill framework-usage -a claude-code`. Or copy the skill folder (.agents/skills/framework-usage in ncatbot/NcatBot) into .claude/skills/framework-usage in your project. Claude Code loads it when a task matches its description.
Run `npx skills add ncatbot/NcatBot --skill framework-usage -a codex`. Or copy the skill folder (.agents/skills/framework-usage in ncatbot/NcatBot) into .agents/skills/framework-usage in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ncatbot/NcatBot --skill framework-usage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/framework-usage, .gemini/skills/framework-usage, .github/skills/framework-usage and .opencode/skills/framework-usage in your project.
SKILL.md names no scripts, command-line tools or credentials: Framework Usage is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Framework Usage is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.2k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 25k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Framework Usage: Configuring Horizon (coollabsio/coolify, 63k stars), K8s Security Policies (Cybereason-Public/owLSM, 280 stars), Payload (payloadcms/payload, 45k stars) and Convex Setup Auth (spokvulcan/poker-planning, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
ncatbot (a GitHub organization) maintains it in ncatbot/NcatBot, which has 116 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 4, 2026.
Source: ncatbot/NcatBot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.