[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80356":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":20,"hasPages":20,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":16,"starSnapshotCount":16,"syncStatus":17,"lastSyncTime":26,"discoverSource":27},80356,"notion-skills","brianlovin\u002Fnotion-skills","brianlovin","Use Notion as your source of truth for agent skills","https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@brianlovin\u002Fnotion-skills",null,"TypeScript",65,5,61,1,0,2,4,2.33,false,"main",[],"2026-06-12 02:04:01","# notion-skills\n\n> A skill store for your AI coding agents. Create and collaborate on skills in Notion, then install them on your computer.\n\n[![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@brianlovin\u002Fnotion-skills.svg?cacheSeconds=300)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@brianlovin\u002Fnotion-skills)\n\n## Why\n\nAI coding agents (Claude Code, Codex, OpenCode, Cursor, Gemini) all read [skills](https:\u002F\u002Fagentskills.io\u002Fhome) — small `SKILL.md` files that tell an agent what to do and when. The format is shared, but each agent reads from its own folder, and authoring usually means tending markdown files in git to keep them synced across machines and teammates.\n\n`notion-skills` puts your skills in a Notion database. You browse a shared store, install only what you want on each machine, and edit skills the way you edit any other Notion page.\n\n- 🏪 **Browse a shared store.** Pick the skills that fit your workflow instead of syncing everything.\n- ✏️ **Edit in Notion.** Use the rich editor; collaborate live; no IDE, no git, no PR review.\n- 👥 **Built for teams.** One store, shared with everyone; each person installs what's relevant to them.\n- 🤖 **Generate with your agent.** `gen` hands an idea off to your coding agent and writes you a draft.\n- 🎯 **Install once, every agent reads it.** The same skill works in Claude, Codex, Cursor, and the rest.\n\n## Get started\n\n```bash\nbrew install ntn               # the Notion CLI we shell out to\nntn login\n\nnpm install -g @brianlovin\u002Fnotion-skills\nnotion-skills init             # interactive setup: pick a database + agents\n```\n\nThen:\n\n```bash\nnotion-skills list                    # browse the store\nnotion-skills install \u003Cslug>          # install one skill\nnotion-skills install --tag featured  # install everything tagged \"featured\"\nnotion-skills sync                    # pull updates for installed skills\nnotion-skills publish \u003Cslug>          # share a local skill with the team\n```\n\nType `\u002Fskill-name` in any agent CLI to invoke an installed skill.\n\nRequires macOS or Linux and Node.js 18+.\n\n## Commands\n\n| Command | What it does |\n|---|---|\n| `init` | First-time setup: create or link a Notion skill store. Re-run to add another source. |\n| `list` | See what's in the store(s). Filter with `--installed`, `--available`, `--outdated`, `--drafts`, `--tag`, `--source`. Sort with `--sort name\\|popular\\|new`. |\n| `install \u003Cslug>` | Pull a skill onto your machine. Refs are bare (`deploy`) or qualified (`team\u002Fdeploy`). Bulk: `--tag`, `--all` (source-scoped). |\n| `uninstall \u003Cslug>` | Remove from your machine. The Notion page stays. |\n| `sync` | Pull updates for installed skills across every source. |\n| `gen \u003Cinput>` | Generate a new skill from a URL, file, or prompt. Local-only until you `publish`. |\n| `add \u003Cowner\u002Frepo>` | Pull a public skill from a GitHub repo (mirrors [skills.sh](https:\u002F\u002Fskills.sh) syntax). Lands as a local draft; `--publish` chains straight to a Notion source. |\n| `feed` | What's new across your stores: newly published skills + updates to skills you have installed. Defaults to the last 7 days; `--since 30d`, `--since 2w`, `--since 12h` for other windows. |\n| `feedback \u003Cslug> [message...]` | Read or post Notion comments on a skill. Bare reads existing comments newest-first; with a message, posts one. Maintainers see threads where they already live. |\n| `audit [slugs...]` | Quality checks (description, body, test markers, agent-routing keywords). Like `npm audit`. |\n| `publish \u003Cslug>` | Push a local skill (or edits) to the store. Bulk: `--all`. Source picker fires for new drafts when 2+ sources exist; `--source` skips. |\n| `unpublish \u003Cslug>` | Archive a skill in the store. |\n| `open \u003Cslug>` | Open the skill in Notion. Use `--local` to open the file in your editor. |\n| `source` | Manage Notion sources: `add`, `list`, `remove`, `default`, `rename`. |\n| `doctor` | Diagnose problems across every source. `--fix` repairs safe issues. |\n\nRun any command with `--help` for the full list of options.\n\n## Drafts\n\nA skill is **ready** or a **draft**. Drafts aren't yet ready for the team — they live on your machine without a Notion row, or in Notion with the `Published` checkbox off. Drafts are skipped by default in install flows; pass `--drafts` to see them or install one by name. Run `publish` to mark a draft ready.\n\n## Multiple sources\n\nA \"source\" is one Notion database. Most users have one (the team store) and never think about it. Larger workflows want more — engineering store, personal store, a department-specific store. Run `notion-skills source add` to link or create another database; bare commands target the **default** source (the first one you set up). Use a qualified ref (`team\u002Fdeploy`) or `--source \u003Ckey>` when you want to be explicit. Tags are source-scoped (each Notion DB has its own tag set), so `--tag` always operates on a single source.\n\nWhen you install two skills with the same slug from different sources, the second one auto-namespaces (`personal-deploy`) so both can coexist. Override with `--as \u003Cname>`.\n\n## What's in a skill?\n\nA directory with a `SKILL.md` file. You can ship extra files alongside it. The [Agent Skills spec](https:\u002F\u002Fagentskills.io\u002Fspecification) defines three optional category directories:\n\n- `scripts\u002F` — executable code the agent runs\n- `references\u002F` — documentation the agent loads on demand\n- `assets\u002F` — static resources (templates, schemas, etc.)\n\nFiles in spec dirs round-trip through Notion as nested sub-pages of a same-named wrapper. Files outside spec dirs become flat root-level child pages.\n\n## Supported agents\n\nClaude, Codex, OpenCode, Cursor, Gemini, plus a generic `~\u002F.agents\u002Fskills\u002F` catch-all. Skills land as symlinks from one central directory, so every agent on your machine sees the same set.\n\n## Troubleshooting\n\n`notion-skills doctor` is the first stop. Common fixes:\n\n- **Auth expired** → `ntn logout && ntn login`\n- **Schema out of date** → `notion-skills upgrade`\n- **Reset everything** → `rm -rf ~\u002F.notion-skills && notion-skills init` (your Notion store is untouched)\n\n## License\n\nMIT\n","notion-skills 是一个用于管理和共享AI编码助手技能的工具。它允许用户通过Notion数据库创建、协作和安装技能，支持丰富的编辑功能，并且可以跨团队共享。核心功能包括浏览共享技能商店、使用Notion进行实时协作编辑、为团队成员提供统一的技能库以及通过AI助手生成技能草稿。适用于需要频繁更新和维护AI编码助手技能的个人开发者或团队，特别是那些希望简化技能管理流程并提高协作效率的场景。","2026-06-11 04:00:27","CREATED_QUERY"]