N.E.K.O is a real-time AI catgirl companion designed to live with the user, initiate interaction, share media, and perform tasks through an emotional engine. It is intended for people seeking a proactive personal digital companion. The catalogue contains skills for working with it.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add Project-N-E-K-O/N.E.K.O --skill skillgit clone --depth 1 https://github.com/Project-N-E-K-O/N.E.K.OWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/project-n-e-k-o/n.e.k.o/skill)<a href="https://agentmods.dev/skills/project-n-e-k-o/n.e.k.o/skill"><img src="https://agentmods.dev/badge/skills/project-n-e-k-o/n.e.k.o/skill.svg" alt="Measured on agentmods" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00000 | $0.00613 |
| Opus 5 | $0.00000 | $0.00307 |
| Sonnet 5 | $0.00000 | $0.00123 |
| Haiku 4.5 | $0.00000 | $0.00061 |
Grade A, and why
skill scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
N.E.K.O 插件模块设计原则（自动遵循）
一、基础架构（强制）
- 类装饰器：必须使用
@neko_plugin，类继承NekoPluginBase。 - 生命周期：至少实现
@lifecycle(id="startup")和@lifecycle(id="shutdown")，返回Ok/Err。 - 入口点：使用
@plugin_entry装饰，必须包含**_参数，返回Ok(...)或Err(SdkError(...))，禁止直接返回 dict 或抛异常。 - Result 类型：所有跨插件调用、可能失败的内部操作都返回
Ok/Err，消费时用isinstance(result, Ok)或unwrap_or。
二、代码风格（硬性）
- 对称性：多个同类组件（如不同 TTS provider）必须保持目录结构和处理路径对称，不得出现数字后缀（如
_2）。 - 异步非阻塞：在 async 函数中禁止同步文件 IO、同步 SQLite、同步 HTTP、CPU 密集循环、
time.sleep。文件 IO 用atomic_write_*_async/read_json_async；SQLite 用a*版本；HTTP 用httpx.AsyncClient；CPU 密集用await asyncio.to_thread(...)。 - 日志规范：使用
self.logger输出调试/信息/警告。任何涉及用户原始对话的内容必须用print，不得用logger。 - i18n 同步：修改用户可见字符串时，必须同时更新
en.json, ja.json, ko.json, zh-CN.json, zh-TW.json, ru.json六个文件，缺一不可。
三、数据与存储
- 持久化：使用
PluginStore做键值存储，或self.data_path()获取data/目录下的文件（如self.data_path("cache.db")）。 - 配置：插件自身配置放在
self.config_dir / "config.json"，使用PluginConfig读取。
四、跨插件与事件
- 跨插件调用：通过
self.plugins.call_entry("other_plugin:entry_id", args)，必须检查返回的Err。 - 事件总线：
self.bus.emit()发布事件，self.bus.on()订阅（通常在 startup 中订阅）。 - 定时任务：使用
@timer_interval，注意共享状态加锁（threading.Lock或asyncio.Lock）。
五、目录与部署
- 目录结构：
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 8d ago First seen · 25 lines · 0 tokens per session scan A ae9030890d88
skill is a skill published in the GitHub repository Project-N-E-K-O/N.E.K.O (2,774 stars, last pushed today), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 613 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
error-recovery-skill
Handle errors gracefully with retry strategies and fallback patterns.
tikhub-skill
Scrape TikTok, Douyin, Instagram, YouTube, Twitter/X, Xiaohongshu, Bilibili, Kuaishou, Weibo, Reddit, Threads, LinkedIn and more through the TikHub pay-per-request API - discover endpoints, call them by id, parse any share URL, and check account balance.
multi-tool-orchestration-skill
Coordinate multiple tools together for complex multi-step tasks.
stripe-skill
Process payments, manage customers, issue refunds, and handle subscriptions via the Stripe CLI. Pass any Stripe command (customers, charges, paymentintents, refunds, invoices, products, prices, subscriptions) and the tool runs it for you and returns parsed JSON.
whatsapp-db-skill
Query WhatsApp database for contacts, groups, channels, and chat history. Look up contact info, search groups, manage channels, retrieve messages.
agent-builder-skill
How to use the Agent Builder tool's five canvas-mutation operations to inspect and grow your own toolset / skills / teammates / workflows mid-execution.