{
    "version": "https://jsonfeed.org/version/1",
    "title": "skillshare Blog",
    "home_page_url": "https://skillshare.runkids.cc/blog",
    "description": "skillshare Blog",
    "items": [
        {
            "id": "https://skillshare.runkids.cc/blog/multi-account-claude-code",
            "content_html": "<p>You have a personal Claude Code subscription and a work one. Or maybe a client gave you access to their team account. Either way, you now have two (or three) separate Claude Code environments — and they're already drifting apart.</p>\n<p>Here's how to set up multiple accounts properly, and how to stop manually copying skills, rules, and hooks between them.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"why-multiple-accounts\">Why Multiple Accounts?<a href=\"https://skillshare.runkids.cc/blog/multi-account-claude-code#why-multiple-accounts\" class=\"hash-link\" aria-label=\"Direct link to Why Multiple Accounts?\" title=\"Direct link to Why Multiple Accounts?\" translate=\"no\">​</a></h2>\n<p>A few common scenarios:</p>\n<ul>\n<li class=\"\"><strong>Personal + Work</strong> — your company pays for a team plan, but you also have your own subscription for side projects</li>\n<li class=\"\"><strong>Personal + Client</strong> — a client added you to their org, but you want to keep your own setup separate</li>\n<li class=\"\"><strong>Multiple orgs</strong> — you consult for several companies, each with their own Claude Code team</li>\n</ul>\n<p>The problem is always the same: you've built up a collection of skills, rules, hooks, and agents in one account, and now you need them in the others too.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-1-set-up-multiple-accounts\">Step 1: Set Up Multiple Accounts<a href=\"https://skillshare.runkids.cc/blog/multi-account-claude-code#step-1-set-up-multiple-accounts\" class=\"hash-link\" aria-label=\"Direct link to Step 1: Set Up Multiple Accounts\" title=\"Direct link to Step 1: Set Up Multiple Accounts\" translate=\"no\">​</a></h2>\n<p>Claude Code stores everything in <code>~/.claude/</code> by default. To add a second account, create a separate directory and point Claude at it with <code>CLAUDE_CONFIG_DIR</code>.</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Create a new config directory for your work account</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token function\" style=\"color:#d73a49\">mkdir</span><span class=\"token plain\"> </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-p</span><span class=\"token plain\"> ~/.claude-work</span><br></span></code></pre></div></div>\n<p>Then add aliases to your <code>~/.zshrc</code> (or <code>~/.bashrc</code>):</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Personal account (default)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token builtin class-name\">alias</span><span class=\"token plain\"> </span><span class=\"token assign-left variable\" style=\"color:#36acaa\">claude</span><span class=\"token operator\" style=\"color:#393A34\">=</span><span class=\"token string\" style=\"color:#e3116c\">\"claude\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Work account</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token builtin class-name\">alias</span><span class=\"token plain\"> claude-work</span><span class=\"token operator\" style=\"color:#393A34\">=</span><span class=\"token string\" style=\"color:#e3116c\">\"CLAUDE_CONFIG_DIR=~/.claude-work claude\"</span><br></span></code></pre></div></div>\n<p>Reload and log in:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token builtin class-name\">source</span><span class=\"token plain\"> ~/.zshrc</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">claude-work   </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># follow the login flow for your work account</span><br></span></code></pre></div></div>\n<p>That's it. <code>claude</code> uses your personal account, <code>claude-work</code> uses your work account. Each has its own API key, conversation history, and settings.</p>\n<p>Need more accounts? Same pattern:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token builtin class-name\">alias</span><span class=\"token plain\"> claude-client</span><span class=\"token operator\" style=\"color:#393A34\">=</span><span class=\"token string\" style=\"color:#e3116c\">\"CLAUDE_CONFIG_DIR=~/.claude-client claude\"</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-2-the-config-drift-problem\">Step 2: The Config Drift Problem<a href=\"https://skillshare.runkids.cc/blog/multi-account-claude-code#step-2-the-config-drift-problem\" class=\"hash-link\" aria-label=\"Direct link to Step 2: The Config Drift Problem\" title=\"Direct link to Step 2: The Config Drift Problem\" translate=\"no\">​</a></h2>\n<p>After a week, here's what happens:</p>\n<div class=\"language-text codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-text codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">~/.claude/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── skills/          ← 12 skills (you just added 2 new ones)</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── rules/           ← 5 rule files</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── hooks/           ← 3 hooks</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">└── agents/          ← 2 agent definitions</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">~/.claude-work/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── skills/          ← 10 skills (missing the 2 new ones)</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── rules/           ← 3 rule files (missing 2)</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── hooks/           ← 1 hook (you forgot to copy the other 2)</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">└── agents/          ← 0 (you never set these up here)</span><br></span></code></pre></div></div>\n<p>You wrote a great debugging skill last Tuesday — but only in your personal account. Your work account still doesn't have it. Your carefully tuned rules about commit message style? Only in one place.</p>\n<p>You could <code>cp -r</code> files around, but:</p>\n<ul>\n<li class=\"\">You'll forget</li>\n<li class=\"\">You'll overwrite something</li>\n<li class=\"\">Files get out of sync silently</li>\n<li class=\"\">Some accounts need different skills than others</li>\n</ul>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-3-sync-skills-automatically\">Step 3: Sync Skills Automatically<a href=\"https://skillshare.runkids.cc/blog/multi-account-claude-code#step-3-sync-skills-automatically\" class=\"hash-link\" aria-label=\"Direct link to Step 3: Sync Skills Automatically\" title=\"Direct link to Step 3: Sync Skills Automatically\" translate=\"no\">​</a></h2>\n<p>This is where <a href=\"https://github.com/runkids/skillshare\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">skillshare</a> comes in. Install it:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># macOS / Linux</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token function\" style=\"color:#d73a49\">curl</span><span class=\"token plain\"> </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-fsSL</span><span class=\"token plain\"> https://raw.githubusercontent.com/runkids/skillshare/main/install.sh </span><span class=\"token operator\" style=\"color:#393A34\">|</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:#d73a49\">sh</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># or via Homebrew</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">brew </span><span class=\"token function\" style=\"color:#d73a49\">install</span><span class=\"token plain\"> skillshare</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Windows (PowerShell)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 </span><span class=\"token operator\" style=\"color:#393A34\">|</span><span class=\"token plain\"> iex</span><br></span></code></pre></div></div>\n<p>Initialize and add your accounts as targets:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare init</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Add each account's skill directory</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare target </span><span class=\"token function\" style=\"color:#d73a49\">add</span><span class=\"token plain\"> claude ~/.claude/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare target </span><span class=\"token function\" style=\"color:#d73a49\">add</span><span class=\"token plain\"> claude-work ~/.claude-work/skills</span><br></span></code></pre></div></div>\n<p>Your config (<code>~/.config/skillshare/config.yaml</code>) now looks like:</p>\n<div class=\"language-yaml codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-yaml codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">claude</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">claude-work</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">work/skills</span><br></span></code></pre></div></div>\n<p>Collect your existing skills into the source, then sync:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Pull existing skills from your primary account into skillshare</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare collect claude</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Sync to all accounts</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><br></span></code></pre></div></div>\n<p>Done. Both accounts now have the same skills.</p>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"filtering-different-skills-for-different-accounts\">Filtering: Different Skills for Different Accounts<a href=\"https://skillshare.runkids.cc/blog/multi-account-claude-code#filtering-different-skills-for-different-accounts\" class=\"hash-link\" aria-label=\"Direct link to Filtering: Different Skills for Different Accounts\" title=\"Direct link to Filtering: Different Skills for Different Accounts\" translate=\"no\">​</a></h3>\n<p>Not every skill belongs everywhere. Your personal <code>side-project-ideas</code> skill probably shouldn't show up at work:</p>\n<div class=\"language-yaml codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-yaml codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">claude</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">claude-work</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">work/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">exclude</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"personal-*\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">claude-client</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">client/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">include</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"coding-*\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"commit\"</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-4-sync-rules-hooks-and-agents\">Step 4: Sync Rules, Hooks, and Agents<a href=\"https://skillshare.runkids.cc/blog/multi-account-claude-code#step-4-sync-rules-hooks-and-agents\" class=\"hash-link\" aria-label=\"Direct link to Step 4: Sync Rules, Hooks, and Agents\" title=\"Direct link to Step 4: Sync Rules, Hooks, and Agents\" translate=\"no\">​</a></h2>\n<p>Skills are only part of the picture. You also want your <strong>rules</strong> (coding standards, locale preferences), <strong>hooks</strong> (auto-format on save, test runners), and <strong>agents</strong> synced across accounts.</p>\n<p>skillshare's <strong>extras</strong> feature handles this — it syncs any directory, not just skills.</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Sync rules across accounts</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare extras init claude-rules </span><span class=\"token punctuation\" style=\"color:#393A34\">\\</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--source</span><span class=\"token plain\"> ~/.claude/rules </span><span class=\"token punctuation\" style=\"color:#393A34\">\\</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--target</span><span class=\"token plain\"> ~/.claude-work/rules</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Sync hooks</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare extras init claude-hooks </span><span class=\"token punctuation\" style=\"color:#393A34\">\\</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--source</span><span class=\"token plain\"> ~/.claude/hooks </span><span class=\"token punctuation\" style=\"color:#393A34\">\\</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--target</span><span class=\"token plain\"> ~/.claude-work/hooks</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Sync agents (use --flatten because Claude discovers agents at top level only)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare extras init claude-agents </span><span class=\"token punctuation\" style=\"color:#393A34\">\\</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--source</span><span class=\"token plain\"> ~/.claude/agents </span><span class=\"token punctuation\" style=\"color:#393A34\">\\</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--target</span><span class=\"token plain\"> ~/.claude-work/agents </span><span class=\"token punctuation\" style=\"color:#393A34\">\\</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--flatten</span><br></span></code></pre></div></div>\n<p>Or put it all in the config:</p>\n<div class=\"language-yaml codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-yaml codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token key atrule\" style=\"color:#00a4db\">extras</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">name</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">rules</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">source</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude/rules</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">work/rules</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token key atrule\" style=\"color:#00a4db\">mode</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> merge</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">client/rules</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token key atrule\" style=\"color:#00a4db\">mode</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> merge</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">name</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">hooks</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">source</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude/hooks</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">work/hooks</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token key atrule\" style=\"color:#00a4db\">mode</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> merge</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">name</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">agents</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">source</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude/agents</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">work/agents</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token key atrule\" style=\"color:#00a4db\">mode</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> merge</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token key atrule\" style=\"color:#00a4db\">flatten</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> </span><span class=\"token boolean important\" style=\"color:#36acaa\">true</span><br></span></code></pre></div></div>\n<p><strong>Why <code>merge</code> mode?</strong> It creates per-file symlinks from target to source, so account-specific files (like <code>settings.json</code> or <code>settings.local.json</code>) are left untouched. Your shared config syncs; your account-specific config stays separate.</p>\n<p>Now sync everything:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><span class=\"token plain\"> </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--all</span><span class=\"token plain\">   </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># skills + extras in one command</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"the-daily-workflow\">The Daily Workflow<a href=\"https://skillshare.runkids.cc/blog/multi-account-claude-code#the-daily-workflow\" class=\"hash-link\" aria-label=\"Direct link to The Daily Workflow\" title=\"Direct link to The Daily Workflow\" translate=\"no\">​</a></h2>\n<p>Once set up, keeping accounts in sync takes three commands:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare check        </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># any upstream skill updates?</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare update </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--all</span><span class=\"token plain\"> </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># pull latest versions</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><span class=\"token plain\"> </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--all</span><span class=\"token plain\">   </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># push to all accounts</span><br></span></code></pre></div></div>\n<p>Write a new skill in your personal account → <code>skillshare sync</code> → it's everywhere.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"full-config-reference\">Full Config Reference<a href=\"https://skillshare.runkids.cc/blog/multi-account-claude-code#full-config-reference\" class=\"hash-link\" aria-label=\"Direct link to Full Config Reference\" title=\"Direct link to Full Config Reference\" translate=\"no\">​</a></h2>\n<p>Here's a complete three-account setup:</p>\n<div class=\"language-yaml codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-yaml codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># ~/.config/skillshare/config.yaml</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">claude</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">claude-work</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">work/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">exclude</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"personal-*\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">claude-client</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">client/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">include</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"coding-*\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"commit\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token key atrule\" style=\"color:#00a4db\">extras</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">name</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">rules</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">source</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude/rules</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">work/rules</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token key atrule\" style=\"color:#00a4db\">mode</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> merge</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">client/rules</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token key atrule\" style=\"color:#00a4db\">mode</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> merge</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">name</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">hooks</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">source</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude/hooks</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">work/hooks</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token key atrule\" style=\"color:#00a4db\">mode</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> merge</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">name</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">agents</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">source</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude/agents</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">work/agents</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token key atrule\" style=\"color:#00a4db\">mode</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> merge</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token key atrule\" style=\"color:#00a4db\">flatten</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> </span><span class=\"token boolean important\" style=\"color:#36acaa\">true</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"bonus-manage-everything-from-the-web-ui\">Bonus: Manage Everything from the Web UI<a href=\"https://skillshare.runkids.cc/blog/multi-account-claude-code#bonus-manage-everything-from-the-web-ui\" class=\"hash-link\" aria-label=\"Direct link to Bonus: Manage Everything from the Web UI\" title=\"Direct link to Bonus: Manage Everything from the Web UI\" translate=\"no\">​</a></h2>\n<p>Prefer a visual interface over YAML? Over half of skillshare users manage their setup through the built-in web dashboard instead of editing config files by hand.</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare ui</span><br></span></code></pre></div></div>\n<p>This opens a dashboard at <code>localhost:19420</code> where you can:</p>\n<ul>\n<li class=\"\">View and manage all skills, targets, and extras</li>\n<li class=\"\">Install new skills from GitHub with one click</li>\n<li class=\"\">Run sync, audit, and check operations visually</li>\n<li class=\"\">Edit target include/exclude filters without touching YAML</li>\n</ul>\n<p><img decoding=\"async\" loading=\"lazy\" alt=\"skillshare UI dashboard\" src=\"https://skillshare.runkids.cc/assets/images/web-dashboard-demo2-163b1a05cf3f173e76f657dc2180ac8b.png\" width=\"3024\" height=\"1650\" class=\"img_ev3q\"></p>\n<p>Everything you can do in the CLI, you can do in the UI — including setting up the multi-account extras config described above.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"quick-tips\">Quick Tips<a href=\"https://skillshare.runkids.cc/blog/multi-account-claude-code#quick-tips\" class=\"hash-link\" aria-label=\"Direct link to Quick Tips\" title=\"Direct link to Quick Tips\" translate=\"no\">​</a></h2>\n<ul>\n<li class=\"\"><strong>Pick one primary account</strong> as the source of truth. Edit skills, rules, and hooks there; sync to the rest.</li>\n<li class=\"\"><strong>Preview before syncing</strong> — <code>skillshare sync --all --dry-run</code> shows what will change.</li>\n<li class=\"\"><strong>Flatten agents</strong> — Claude Code only discovers agents at the top level, so always use <code>flatten: true</code> for agent directories.</li>\n<li class=\"\"><strong>Backup first</strong> — <code>skillshare backup</code> snapshots your current state before changes.</li>\n</ul>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"get-started\">Get Started<a href=\"https://skillshare.runkids.cc/blog/multi-account-claude-code#get-started\" class=\"hash-link\" aria-label=\"Direct link to Get Started\" title=\"Direct link to Get Started\" translate=\"no\">​</a></h2>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token function\" style=\"color:#d73a49\">curl</span><span class=\"token plain\"> </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-fsSL</span><span class=\"token plain\"> https://raw.githubusercontent.com/runkids/skillshare/main/install.sh </span><span class=\"token operator\" style=\"color:#393A34\">|</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:#d73a49\">sh</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare init</span><br></span></code></pre></div></div>\n<ul>\n<li class=\"\"><a href=\"https://github.com/runkids/skillshare\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">GitHub</a></li>\n<li class=\"\"><a href=\"https://skillshare.runkids.cc/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">Documentation</a></li>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/reference/commands/extras\">Extras reference</a></li>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/understand/sync-modes\">Sync modes explained</a></li>\n</ul>",
            "url": "https://skillshare.runkids.cc/blog/multi-account-claude-code",
            "title": "Running Multiple Claude Code Accounts? Here's How to Keep Them in Sync",
            "summary": "You have a personal Claude Code subscription and a work one. Or maybe a client gave you access to their team account. Either way, you now have two (or three) separate Claude Code environments — and they're already drifting apart.",
            "date_modified": "2026-04-05T00:00:00.000Z",
            "author": {
                "name": "runkids",
                "url": "https://github.com/runkids"
            },
            "tags": [
                "tutorial",
                "extras",
                "multi-account"
            ]
        },
        {
            "id": "https://skillshare.runkids.cc/blog/5-min-claude-code-skills",
            "content_html": "<p>Getting Claude Code skills organized shouldn't take more than a coffee break. Here's how to go from zero to a fully managed skill library in under 5 minutes.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"the-problem\">The Problem<a href=\"https://skillshare.runkids.cc/blog/5-min-claude-code-skills#the-problem\" class=\"hash-link\" aria-label=\"Direct link to The Problem\" title=\"Direct link to The Problem\" translate=\"no\">​</a></h2>\n<p>Claude Code stores skills in <code>~/.claude/skills/</code>. Over time, you accumulate skills from different sources — some you wrote, some from teammates, some from GitHub. Without structure, it becomes hard to track what's installed, what's outdated, and what conflicts with what.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-1-install-skillshare\">Step 1: Install skillshare<a href=\"https://skillshare.runkids.cc/blog/5-min-claude-code-skills#step-1-install-skillshare\" class=\"hash-link\" aria-label=\"Direct link to Step 1: Install skillshare\" title=\"Direct link to Step 1: Install skillshare\" translate=\"no\">​</a></h2>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token function\" style=\"color:#d73a49\">curl</span><span class=\"token plain\"> </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-fsSL</span><span class=\"token plain\"> https://raw.githubusercontent.com/runkids/skillshare/main/install.sh </span><span class=\"token operator\" style=\"color:#393A34\">|</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:#d73a49\">sh</span><br></span></code></pre></div></div>\n<p>Or via Homebrew (macOS/Linux):</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">brew </span><span class=\"token function\" style=\"color:#d73a49\">install</span><span class=\"token plain\"> skillshare</span><br></span></code></pre></div></div>\n<div class=\"theme-admonition theme-admonition-note admonition_xJq3 alert alert--secondary\"><div class=\"admonitionHeading_Gvgb\"><span class=\"admonitionIcon_Rf37\"><svg viewBox=\"0 0 14 16\"><path fill-rule=\"evenodd\" d=\"M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z\"></path></svg></span>note</div><div class=\"admonitionContent_BuS1\"><p>Homebrew releases may lag behind the latest version by a few days. For the newest release, use the install script above.</p></div></div>\n<p>Verify:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare version</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-2-initialize\">Step 2: Initialize<a href=\"https://skillshare.runkids.cc/blog/5-min-claude-code-skills#step-2-initialize\" class=\"hash-link\" aria-label=\"Direct link to Step 2: Initialize\" title=\"Direct link to Step 2: Initialize\" translate=\"no\">​</a></h2>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare init</span><br></span></code></pre></div></div>\n<p>This creates a source directory at <code>~/.config/skillshare/skills/</code> and auto-detects Claude Code as a sync target.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-3-import-your-existing-skills\">Step 3: Import Your Existing Skills<a href=\"https://skillshare.runkids.cc/blog/5-min-claude-code-skills#step-3-import-your-existing-skills\" class=\"hash-link\" aria-label=\"Direct link to Step 3: Import Your Existing Skills\" title=\"Direct link to Step 3: Import Your Existing Skills\" translate=\"no\">​</a></h2>\n<p>Already have skills in <code>~/.claude/skills/</code>? Collect them into your source:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare collect</span><br></span></code></pre></div></div>\n<p>skillshare copies each skill from Claude Code's directory into your source. Now you have a single place that holds everything.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-4-install-a-skill-from-github\">Step 4: Install a Skill from GitHub<a href=\"https://skillshare.runkids.cc/blog/5-min-claude-code-skills#step-4-install-a-skill-from-github\" class=\"hash-link\" aria-label=\"Direct link to Step 4: Install a Skill from GitHub\" title=\"Direct link to Step 4: Install a Skill from GitHub\" translate=\"no\">​</a></h2>\n<p>Let's add a popular skill set:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">install</span><span class=\"token plain\"> anthropics/courses/prompt-eng</span><br></span></code></pre></div></div>\n<p>This clones the repository and places skills in your source directory. Run <code>skillshare list</code> to see everything:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare list</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-5-sync\">Step 5: Sync<a href=\"https://skillshare.runkids.cc/blog/5-min-claude-code-skills#step-5-sync\" class=\"hash-link\" aria-label=\"Direct link to Step 5: Sync\" title=\"Direct link to Step 5: Sync\" translate=\"no\">​</a></h2>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><br></span></code></pre></div></div>\n<p>By default, skillshare uses <strong>merge mode</strong> — creating per-skill symlinks from your source into <code>~/.claude/skills/</code>. Your original local skills are preserved — only new ones are added.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-6-verify\">Step 6: Verify<a href=\"https://skillshare.runkids.cc/blog/5-min-claude-code-skills#step-6-verify\" class=\"hash-link\" aria-label=\"Direct link to Step 6: Verify\" title=\"Direct link to Step 6: Verify\" translate=\"no\">​</a></h2>\n<p>Open Claude Code and check that your skills are available:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">claude</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Inside Claude Code, your skills should be loaded</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"symlink-not-working-use-copy-mode\">Symlink Not Working? Use Copy Mode<a href=\"https://skillshare.runkids.cc/blog/5-min-claude-code-skills#symlink-not-working-use-copy-mode\" class=\"hash-link\" aria-label=\"Direct link to Symlink Not Working? Use Copy Mode\" title=\"Direct link to Symlink Not Working? Use Copy Mode\" translate=\"no\">​</a></h2>\n<p>Some platforms and tools have inconsistent symlink support — WSL, certain Docker setups, or AI tools that don't follow symlinks. If you run into issues:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare target claude </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--mode</span><span class=\"token plain\"> copy</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><br></span></code></pre></div></div>\n<p>Copy mode physically copies skill files instead of symlinking. The trade-off:</p>\n<table><thead><tr><th></th><th>Merge (symlink)</th><th>Copy</th></tr></thead><tbody><tr><td>Source changes reflected</td><td>Instantly</td><td>After <code>sync</code></td></tr><tr><td>Cross-platform compatibility</td><td>May have issues</td><td>Works everywhere</td></tr><tr><td>Local skill preservation</td><td>Yes</td><td>Yes</td></tr></tbody></table>\n<p>See <a class=\"\" href=\"https://skillshare.runkids.cc/docs/understand/sync-modes\">Sync Modes</a> for the full comparison.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"what-you-get\">What You Get<a href=\"https://skillshare.runkids.cc/blog/5-min-claude-code-skills#what-you-get\" class=\"hash-link\" aria-label=\"Direct link to What You Get\" title=\"Direct link to What You Get\" translate=\"no\">​</a></h2>\n<p>After these steps:</p>\n<ul>\n<li class=\"\"><strong>Single source of truth</strong> — all skills live in <code>~/.config/skillshare/skills/</code></li>\n<li class=\"\"><strong>Non-destructive sync</strong> — local Claude Code skills are untouched</li>\n<li class=\"\"><strong>Version tracking</strong> — installed repos are tracked for updates via <code>skillshare check</code></li>\n<li class=\"\"><strong>Backup ready</strong> — <code>skillshare backup</code> snapshots your entire skill library</li>\n</ul>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"next-steps\">Next Steps<a href=\"https://skillshare.runkids.cc/blog/5-min-claude-code-skills#next-steps\" class=\"hash-link\" aria-label=\"Direct link to Next Steps\" title=\"Direct link to Next Steps\" translate=\"no\">​</a></h2>\n<ul>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/learn/with-multiple-tools\">Set up multi-tool sync</a> if you also use Cursor, Codex, or other tools</li>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/how-to/daily-tasks/creating-skills\">Create your first custom skill</a></li>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/how-to/sharing/organization-sharing\">Share skills with your team</a></li>\n</ul>",
            "url": "https://skillshare.runkids.cc/blog/5-min-claude-code-skills",
            "title": "5 Minutes to Manage Your Claude Code Skills",
            "summary": "Getting Claude Code skills organized shouldn't take more than a coffee break. Here's how to go from zero to a fully managed skill library in under 5 minutes.",
            "date_modified": "2026-02-26T00:00:00.000Z",
            "author": {
                "name": "runkids",
                "url": "https://github.com/runkids"
            },
            "tags": [
                "tutorial",
                "claude-code"
            ]
        },
        {
            "id": "https://skillshare.runkids.cc/blog/managing-50-skills",
            "content_html": "<p>When you use Claude Code, Cursor, and Codex daily, skill management gets chaotic fast. Here's how I keep 50+ skills organized across all three tools with a single workflow.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"the-setup\">The Setup<a href=\"https://skillshare.runkids.cc/blog/managing-50-skills#the-setup\" class=\"hash-link\" aria-label=\"Direct link to The Setup\" title=\"Direct link to The Setup\" translate=\"no\">​</a></h2>\n<p>My daily toolkit:</p>\n<ul>\n<li class=\"\"><strong>Claude Code</strong> — primary coding assistant</li>\n<li class=\"\"><strong>Cursor</strong> — IDE-integrated AI</li>\n<li class=\"\"><strong>Codex</strong> — quick prototyping and script generation</li>\n</ul>\n<p>Each tool has its own skill directory, its own format quirks, and its own update cycle. Without skillshare, I was manually copying files between three locations every time I changed a skill.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"directory-structure\">Directory Structure<a href=\"https://skillshare.runkids.cc/blog/managing-50-skills#directory-structure\" class=\"hash-link\" aria-label=\"Direct link to Directory Structure\" title=\"Direct link to Directory Structure\" translate=\"no\">​</a></h2>\n<p>After <code>skillshare init</code>, my source looks like this:</p>\n<div class=\"language-text codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-text codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">~/.config/skillshare/skills/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── _anthropics__courses__prompt-eng/   # tracked repo</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── _team__frontend/                    # team shared</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── code-review/                        # my custom skill</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── commit-message/                     # my custom skill</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── debugging/                          # organized into folders</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── testing/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">└── frontend/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    ├── react-patterns/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    ├── css-guidelines/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    └── accessibility/</span><br></span></code></pre></div></div>\n<p>Skills prefixed with <code>_</code> are tracked repositories. The rest are local skills organized into logical groups.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"organizing-with---into\">Organizing with <code>--into</code><a href=\"https://skillshare.runkids.cc/blog/managing-50-skills#organizing-with---into\" class=\"hash-link\" aria-label=\"Direct link to organizing-with---into\" title=\"Direct link to organizing-with---into\" translate=\"no\">​</a></h2>\n<p>The <code>--into</code> flag places installed skills into subdirectories:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">install</span><span class=\"token plain\"> user/repo </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--into</span><span class=\"token plain\"> frontend</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">install</span><span class=\"token plain\"> another/repo </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--into</span><span class=\"token plain\"> backend</span><br></span></code></pre></div></div>\n<p>This creates a clean hierarchy without flat-file chaos.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"multi-target-sync\">Multi-Target Sync<a href=\"https://skillshare.runkids.cc/blog/managing-50-skills#multi-target-sync\" class=\"hash-link\" aria-label=\"Direct link to Multi-Target Sync\" title=\"Direct link to Multi-Target Sync\" translate=\"no\">​</a></h2>\n<p>Global config targets use a map format:</p>\n<div class=\"language-yaml codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-yaml codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">claude</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">cursor</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.cursor/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">codex</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.codex/skills</span><br></span></code></pre></div></div>\n<p>One <code>skillshare sync</code> pushes all 50+ skills to all three tools simultaneously. Each target gets per-skill symlinks, so tool-specific local skills remain untouched.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"per-target-mode-and-filtering\">Per-Target Mode and Filtering<a href=\"https://skillshare.runkids.cc/blog/managing-50-skills#per-target-mode-and-filtering\" class=\"hash-link\" aria-label=\"Direct link to Per-Target Mode and Filtering\" title=\"Direct link to Per-Target Mode and Filtering\" translate=\"no\">​</a></h2>\n<p>You can set a different sync mode per target, and use <code>include</code>/<code>exclude</code> patterns to control which skills go where:</p>\n<div class=\"language-yaml codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-yaml codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">claude</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">mode</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> merge</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">cursor</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.cursor/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">mode</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> copy          </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># copy mode for better compatibility</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">exclude</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"_experimental*\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">codex</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.codex/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">mode</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> merge</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">include</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"coding-*\"</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"daily-workflow\">Daily Workflow<a href=\"https://skillshare.runkids.cc/blog/managing-50-skills#daily-workflow\" class=\"hash-link\" aria-label=\"Direct link to Daily Workflow\" title=\"Direct link to Daily Workflow\" translate=\"no\">​</a></h2>\n<p>My morning routine takes about 30 seconds:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Check for upstream updates</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare check</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># If updates available</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare update </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--all</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Sync to all targets</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><br></span></code></pre></div></div>\n<p>That's it. Three tools, 50+ skills, one command chain.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"handling-conflicts\">Handling Conflicts<a href=\"https://skillshare.runkids.cc/blog/managing-50-skills#handling-conflicts\" class=\"hash-link\" aria-label=\"Direct link to Handling Conflicts\" title=\"Direct link to Handling Conflicts\" translate=\"no\">​</a></h2>\n<p>Occasionally, a tool creates a skill with the same name as one in my source. skillshare handles this gracefully:</p>\n<ul>\n<li class=\"\">In <strong>merge mode</strong>, the symlink points to your source skill</li>\n<li class=\"\">The target's original file is not deleted — it's simply overshadowed by the symlink</li>\n<li class=\"\">Running <code>skillshare diff</code> shows exactly what differs between source and target</li>\n</ul>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"backup-strategy\">Backup Strategy<a href=\"https://skillshare.runkids.cc/blog/managing-50-skills#backup-strategy\" class=\"hash-link\" aria-label=\"Direct link to Backup Strategy\" title=\"Direct link to Backup Strategy\" translate=\"no\">​</a></h2>\n<p>Before major changes, I snapshot:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare backup</span><br></span></code></pre></div></div>\n<p>Backups are stored in <code>~/.local/share/skillshare/backups/</code> with timestamps. To restore a specific target:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare restore claude</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"key-takeaways\">Key Takeaways<a href=\"https://skillshare.runkids.cc/blog/managing-50-skills#key-takeaways\" class=\"hash-link\" aria-label=\"Direct link to Key Takeaways\" title=\"Direct link to Key Takeaways\" translate=\"no\">​</a></h2>\n<ol>\n<li class=\"\"><strong>One source, many targets</strong> — the fundamental principle</li>\n<li class=\"\"><strong>Use <code>--into</code> for organization</strong> — avoid flat directory sprawl</li>\n<li class=\"\"><strong>Check + update + sync</strong> — the daily three-command chain</li>\n<li class=\"\"><strong>Backup before experiments</strong> — it takes 2 seconds and saves hours</li>\n</ol>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"resources\">Resources<a href=\"https://skillshare.runkids.cc/blog/managing-50-skills#resources\" class=\"hash-link\" aria-label=\"Direct link to Resources\" title=\"Direct link to Resources\" translate=\"no\">​</a></h2>\n<ul>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/learn/with-multiple-tools\">Multi-tool quickstart</a></li>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/how-to/daily-tasks/organizing-skills\">Organizing skills guide</a></li>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/how-to/daily-tasks/backup-restore\">Backup &amp; restore guide</a></li>\n</ul>",
            "url": "https://skillshare.runkids.cc/blog/managing-50-skills",
            "title": "How I Manage 50+ Skills Across 3 AI Tools",
            "summary": "When you use Claude Code, Cursor, and Codex daily, skill management gets chaotic fast. Here's how I keep 50+ skills organized across all three tools with a single workflow.",
            "date_modified": "2026-02-26T00:00:00.000Z",
            "author": {
                "name": "runkids",
                "url": "https://github.com/runkids"
            },
            "tags": [
                "tutorial",
                "advanced"
            ]
        },
        {
            "id": "https://skillshare.runkids.cc/blog/migrate-from-vercel-skills",
            "content_html": "<p><a href=\"https://github.com/vercel-labs/skills\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">vercel/skills</a> and skillshare are both CLI tools for managing AI coding skills across multiple agents. If you're choosing between them — or considering a migration — here's an honest comparison.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"what-they-have-in-common\">What They Have in Common<a href=\"https://skillshare.runkids.cc/blog/migrate-from-vercel-skills#what-they-have-in-common\" class=\"hash-link\" aria-label=\"Direct link to What They Have in Common\" title=\"Direct link to What They Have in Common\" translate=\"no\">​</a></h2>\n<p>Both tools solve the same core problem: managing AI skill files across 40+ coding agents (Claude Code, Cursor, Codex, etc.). Both offer:</p>\n<ul>\n<li class=\"\">Install skills from Git repositories (GitHub, GitLab, and other hosts)</li>\n<li class=\"\">Sync to multiple AI tool targets</li>\n<li class=\"\">Support for symlink and copy modes</li>\n<li class=\"\">Project-level and global skill management</li>\n<li class=\"\">Security audit before installation</li>\n</ul>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"where-vercelskills-shines\">Where vercel/skills Shines<a href=\"https://skillshare.runkids.cc/blog/migrate-from-vercel-skills#where-vercelskills-shines\" class=\"hash-link\" aria-label=\"Direct link to Where vercel/skills Shines\" title=\"Direct link to Where vercel/skills Shines\" translate=\"no\">​</a></h2>\n<p><strong>Best for quick, curated installs:</strong></p>\n<ul>\n<li class=\"\">Runs via <code>npx skills</code> — no binary installation needed if you have Node.js</li>\n<li class=\"\">Curated skill discovery via <code>npx skills find</code> with interactive selection</li>\n<li class=\"\"><a href=\"https://vercel.com/changelog/automated-security-audits-now-available-for-skills-sh\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">Server-side security audit</a> powered by Snyk — skills on the catalog are automatically scanned and flagged</li>\n<li class=\"\">Strong Vercel/Next.js ecosystem integration</li>\n<li class=\"\">Familiar npm-based workflow for JavaScript developers</li>\n</ul>\n<p><strong>Use vercel/skills when:</strong></p>\n<ul>\n<li class=\"\">You're already in the Node.js ecosystem</li>\n<li class=\"\">You primarily install from the skills.sh catalog (which provides pre-audited skills)</li>\n<li class=\"\">You want a curated, community-driven skill catalog</li>\n<li class=\"\">You prefer <code>npx</code>-based tooling with no permanent install</li>\n<li class=\"\">Your workflow is primarily single-machine, single-project</li>\n</ul>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"where-skillshare-shines\">Where skillshare Shines<a href=\"https://skillshare.runkids.cc/blog/migrate-from-vercel-skills#where-skillshare-shines\" class=\"hash-link\" aria-label=\"Direct link to Where skillshare Shines\" title=\"Direct link to Where skillshare Shines\" translate=\"no\">​</a></h2>\n<p><strong>Best for multi-tool sync, multi-platform, and team workflows:</strong></p>\n<ul>\n<li class=\"\">Single binary — no Node.js, npm, or runtime dependencies</li>\n<li class=\"\"><strong>Any Git host</strong> — GitHub, GitLab, Bitbucket, Gitea, Azure DevOps, AtomGit, Codeberg, self-hosted, and any HTTPS/SSH git server</li>\n<li class=\"\">Bidirectional sync: collect skills from targets back to source</li>\n<li class=\"\">Cross-machine sync via <code>push</code>/<code>pull</code></li>\n<li class=\"\"><strong>Fully customizable security audit</strong> — 15+ detection patterns, configurable block thresholds, <a class=\"\" href=\"https://skillshare.runkids.cc/docs/how-to/advanced/security\">custom rules</a> to enable/disable individual patterns, and multiple output formats (text, JSON, SARIF, Markdown). Runs locally on any skill source — no server dependency</li>\n<li class=\"\">Pre-commit hook integration via the <a href=\"https://pre-commit.com/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">pre-commit</a> framework</li>\n<li class=\"\">Backup/restore with timestamped snapshots</li>\n<li class=\"\">Web dashboard (<code>skillshare ui</code>)</li>\n<li class=\"\">Organization-wide skill distribution via tracked repos</li>\n<li class=\"\">Works offline (core operations need no network)</li>\n</ul>\n<p><strong>Use skillshare when:</strong></p>\n<ul>\n<li class=\"\">You use multiple AI tools and need one source of truth</li>\n<li class=\"\">Your skills live on GitLab, Bitbucket, Azure DevOps, or self-hosted Git — not just GitHub</li>\n<li class=\"\">You work across multiple machines</li>\n<li class=\"\">Your team needs standardized skills via git</li>\n<li class=\"\">You need <strong>customizable</strong> security scanning — your own rules, thresholds, and CI integration for any skill source (not just a public catalog)</li>\n<li class=\"\">You want zero runtime dependencies (CI/CD, Docker, air-gapped environments)</li>\n</ul>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"feature-comparison\">Feature Comparison<a href=\"https://skillshare.runkids.cc/blog/migrate-from-vercel-skills#feature-comparison\" class=\"hash-link\" aria-label=\"Direct link to Feature Comparison\" title=\"Direct link to Feature Comparison\" translate=\"no\">​</a></h2>\n<table><thead><tr><th>Feature</th><th>vercel/skills</th><th>skillshare</th></tr></thead><tbody><tr><td>Install method</td><td><code>npx</code> (Node.js)</td><td>Single binary</td></tr><tr><td>Git platform support</td><td>GitHub, GitLab, any git URL</td><td>GitHub, GitLab, Bitbucket, Gitea, GHE, Azure DevOps, AtomGit, Codeberg, any HTTPS/SSH host</td></tr><tr><td>Sync modes</td><td>Symlink, copy</td><td>Merge (per-skill symlink), symlink, copy</td></tr><tr><td>Multi-tool sync</td><td>Yes</td><td>Yes</td></tr><tr><td>Collect (target → source)</td><td>No</td><td>Yes</td></tr><tr><td>Cross-machine sync</td><td>No</td><td>Yes (<code>push</code>/<code>pull</code>)</td></tr><tr><td>Security audit</td><td>Yes (server-side via Snyk, catalog skills)</td><td>Yes (local, 15+ patterns, custom rules, any source)</td></tr><tr><td>Custom audit rules</td><td>No</td><td>Yes (enable/disable patterns, configurable thresholds)</td></tr><tr><td>Pre-commit hook</td><td>No</td><td>Yes (<a href=\"https://pre-commit.com/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">pre-commit</a> framework)</td></tr><tr><td>Audit output formats</td><td>CLI display</td><td>Text, JSON, SARIF, Markdown</td></tr><tr><td>Backup/restore</td><td>No</td><td>Yes</td></tr><tr><td>Web UI</td><td>No</td><td>Yes</td></tr><tr><td>Hub/registry</td><td>Community catalog (skills.sh)</td><td>Self-hosted hub index</td></tr><tr><td>Offline operation</td><td>Needs npm</td><td>Yes (core operations)</td></tr><tr><td>Project skills</td><td>Yes</td><td>Yes</td></tr></tbody></table>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"migrating-from-vercelskills\">Migrating from vercel/skills<a href=\"https://skillshare.runkids.cc/blog/migrate-from-vercel-skills#migrating-from-vercelskills\" class=\"hash-link\" aria-label=\"Direct link to Migrating from vercel/skills\" title=\"Direct link to Migrating from vercel/skills\" translate=\"no\">​</a></h2>\n<p>If you decide to switch, the process is straightforward:</p>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-1-install-skillshare\">Step 1: Install skillshare<a href=\"https://skillshare.runkids.cc/blog/migrate-from-vercel-skills#step-1-install-skillshare\" class=\"hash-link\" aria-label=\"Direct link to Step 1: Install skillshare\" title=\"Direct link to Step 1: Install skillshare\" translate=\"no\">​</a></h3>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token function\" style=\"color:#d73a49\">curl</span><span class=\"token plain\"> </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-fsSL</span><span class=\"token plain\"> https://raw.githubusercontent.com/runkids/skillshare/main/install.sh </span><span class=\"token operator\" style=\"color:#393A34\">|</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:#d73a49\">sh</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare init</span><br></span></code></pre></div></div>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-2-collect-existing-skills\">Step 2: Collect existing skills<a href=\"https://skillshare.runkids.cc/blog/migrate-from-vercel-skills#step-2-collect-existing-skills\" class=\"hash-link\" aria-label=\"Direct link to Step 2: Collect existing skills\" title=\"Direct link to Step 2: Collect existing skills\" translate=\"no\">​</a></h3>\n<p>If vercel/skills already synced skills to your AI tool directories:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare collect</span><br></span></code></pre></div></div>\n<p>This copies skills from your target directories into skillshare's source.</p>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-3-sync\">Step 3: Sync<a href=\"https://skillshare.runkids.cc/blog/migrate-from-vercel-skills#step-3-sync\" class=\"hash-link\" aria-label=\"Direct link to Step 3: Sync\" title=\"Direct link to Step 3: Sync\" translate=\"no\">​</a></h3>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><br></span></code></pre></div></div>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-4-ongoing-updates\">Step 4: Ongoing updates<a href=\"https://skillshare.runkids.cc/blog/migrate-from-vercel-skills#step-4-ongoing-updates\" class=\"hash-link\" aria-label=\"Direct link to Step 4: Ongoing updates\" title=\"Direct link to Step 4: Ongoing updates\" translate=\"no\">​</a></h3>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare check          </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Detect upstream changes</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare update </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--all</span><span class=\"token plain\">   </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Apply updates</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><span class=\"token plain\">           </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Push to all tools</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"can-they-coexist\">Can They Coexist?<a href=\"https://skillshare.runkids.cc/blog/migrate-from-vercel-skills#can-they-coexist\" class=\"hash-link\" aria-label=\"Direct link to Can They Coexist?\" title=\"Direct link to Can They Coexist?\" translate=\"no\">​</a></h2>\n<p>Yes. Both tools use symlinks (or copies) to the same target directories. However, running both simultaneously on the same targets may cause conflicts — one tool's symlinks may be overwritten by the other. If you're evaluating both, use them on separate targets or test one at a time.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"resources\">Resources<a href=\"https://skillshare.runkids.cc/blog/migrate-from-vercel-skills#resources\" class=\"hash-link\" aria-label=\"Direct link to Resources\" title=\"Direct link to Resources\" translate=\"no\">​</a></h2>\n<ul>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/how-to/advanced/migration\">Migration guide</a></li>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/reference/commands/install\">Install command reference</a></li>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/how-to/advanced/security\">Security audit guide</a></li>\n</ul>",
            "url": "https://skillshare.runkids.cc/blog/migrate-from-vercel-skills",
            "title": "skillshare vs. vercel/skills — When to Use Which",
            "summary": "vercel/skills and skillshare are both CLI tools for managing AI coding skills across multiple agents. If you're choosing between them — or considering a migration — here's an honest comparison.",
            "date_modified": "2026-02-26T00:00:00.000Z",
            "author": {
                "name": "runkids",
                "url": "https://github.com/runkids"
            },
            "tags": [
                "comparison"
            ]
        },
        {
            "id": "https://skillshare.runkids.cc/blog/team-sharing-patterns",
            "content_html": "<p>Every team eventually faces the question: \"How do we share AI skills across the team?\" Here are three patterns, from simplest to most structured, with skillshare handling the mechanics.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"pattern-1-shared-git-repository\">Pattern 1: Shared Git Repository<a href=\"https://skillshare.runkids.cc/blog/team-sharing-patterns#pattern-1-shared-git-repository\" class=\"hash-link\" aria-label=\"Direct link to Pattern 1: Shared Git Repository\" title=\"Direct link to Pattern 1: Shared Git Repository\" translate=\"no\">​</a></h2>\n<p><strong>Best for:</strong> Small teams (2-5 people) who want a quick start.</p>\n<p>Create a Git repository with your team's skills:</p>\n<div class=\"language-text codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-text codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">team-skills/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── code-review/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">│   └── SKILL.md</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">├── pr-description/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">│   └── SKILL.md</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">└── testing-standards/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    └── SKILL.md</span><br></span></code></pre></div></div>\n<p>Each team member installs it:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">install</span><span class=\"token plain\"> your-org/team-skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><br></span></code></pre></div></div>\n<p>When someone updates a skill, others pull changes:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare check              </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># \"team-skills: 2 skills updated\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare update </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--all</span><span class=\"token plain\">       </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Apply all available updates</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><br></span></code></pre></div></div>\n<p><strong>Pros:</strong> Simple, familiar Git workflow, works with any Git host.</p>\n<p><strong>Cons:</strong> Everyone gets all skills, no per-project customization.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"pattern-2-organization-wide--project-scoped\">Pattern 2: Organization-Wide + Project-Scoped<a href=\"https://skillshare.runkids.cc/blog/team-sharing-patterns#pattern-2-organization-wide--project-scoped\" class=\"hash-link\" aria-label=\"Direct link to Pattern 2: Organization-Wide + Project-Scoped\" title=\"Direct link to Pattern 2: Organization-Wide + Project-Scoped\" translate=\"no\">​</a></h2>\n<p><strong>Best for:</strong> Medium teams (5-20 people) with different projects.</p>\n<p>Split skills into two layers:</p>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"organization-layer-global\">Organization Layer (global)<a href=\"https://skillshare.runkids.cc/blog/team-sharing-patterns#organization-layer-global\" class=\"hash-link\" aria-label=\"Direct link to Organization Layer (global)\" title=\"Direct link to Organization Layer (global)\" translate=\"no\">​</a></h3>\n<p>Shared standards that apply everywhere:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">install</span><span class=\"token plain\"> your-org/org-skills</span><br></span></code></pre></div></div>\n<p>These live in <code>~/.config/skillshare/skills/</code> and sync to all tools on every machine.</p>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"project-layer-scoped\">Project Layer (scoped)<a href=\"https://skillshare.runkids.cc/blog/team-sharing-patterns#project-layer-scoped\" class=\"hash-link\" aria-label=\"Direct link to Project Layer (scoped)\" title=\"Direct link to Project Layer (scoped)\" translate=\"no\">​</a></h3>\n<p>Project-specific skills committed to the project repo:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token builtin class-name\">cd</span><span class=\"token plain\"> your-project</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare init </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-p</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">install</span><span class=\"token plain\"> your-org/frontend-skills </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-p</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token function\" style=\"color:#d73a49\">git</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:#d73a49\">add</span><span class=\"token plain\"> .skillshare/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token function\" style=\"color:#d73a49\">git</span><span class=\"token plain\"> commit </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-m</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"Add project skills\"</span><br></span></code></pre></div></div>\n<p>Team members get project skills automatically when they clone and run:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><span class=\"token plain\"> </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-p</span><br></span></code></pre></div></div>\n<p><strong>Pros:</strong> Organization standards + project flexibility. Skills travel with the code.</p>\n<p><strong>Cons:</strong> Two sync commands (global + project). Requires project setup.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"pattern-3-hub-index-registry\">Pattern 3: Hub Index (Registry)<a href=\"https://skillshare.runkids.cc/blog/team-sharing-patterns#pattern-3-hub-index-registry\" class=\"hash-link\" aria-label=\"Direct link to Pattern 3: Hub Index (Registry)\" title=\"Direct link to Pattern 3: Hub Index (Registry)\" translate=\"no\">​</a></h2>\n<p><strong>Best for:</strong> Large teams or open-source communities.</p>\n<p>Generate a hub index from your source skills:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare hub index </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--source</span><span class=\"token plain\"> ./skills </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--output</span><span class=\"token plain\"> ./skillshare-hub.json</span><br></span></code></pre></div></div>\n<p>This creates a JSON file listing all available skills with metadata. Host it on GitHub Pages or any HTTPS URL, then register it:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare hub </span><span class=\"token function\" style=\"color:#d73a49\">add</span><span class=\"token plain\"> https://your-org.github.io/skillshare-hub.json </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--label</span><span class=\"token plain\"> team</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare hub default team</span><br></span></code></pre></div></div>\n<p>Team members can then browse and install:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare search </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--hub</span><span class=\"token plain\"> https://your-org.github.io/skillshare-hub.json</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">install</span><span class=\"token plain\"> your-org/skills </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--skill</span><span class=\"token plain\"> code-review</span><br></span></code></pre></div></div>\n<p><strong>Pros:</strong> Discoverable, self-service, scales to hundreds of skills.</p>\n<p><strong>Cons:</strong> Requires maintaining the index. More setup upfront.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"choosing-a-pattern\">Choosing a Pattern<a href=\"https://skillshare.runkids.cc/blog/team-sharing-patterns#choosing-a-pattern\" class=\"hash-link\" aria-label=\"Direct link to Choosing a Pattern\" title=\"Direct link to Choosing a Pattern\" translate=\"no\">​</a></h2>\n<table><thead><tr><th>Factor</th><th>Pattern 1</th><th>Pattern 2</th><th>Pattern 3</th></tr></thead><tbody><tr><td>Setup time</td><td>5 min</td><td>15 min</td><td>30 min</td></tr><tr><td>Team size</td><td>2-5</td><td>5-20</td><td>20+</td></tr><tr><td>Per-project skills</td><td>No</td><td>Yes</td><td>Yes</td></tr><tr><td>Self-service discovery</td><td>No</td><td>No</td><td>Yes</td></tr><tr><td>Maintenance</td><td>Low</td><td>Medium</td><td>Medium</td></tr></tbody></table>\n<p>Most teams start with Pattern 1 and evolve to Pattern 2 when they need project-specific skills. Pattern 3 is for organizations that want a curated skill catalog.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"getting-started\">Getting Started<a href=\"https://skillshare.runkids.cc/blog/team-sharing-patterns#getting-started\" class=\"hash-link\" aria-label=\"Direct link to Getting Started\" title=\"Direct link to Getting Started\" translate=\"no\">​</a></h2>\n<p>Regardless of pattern, the workflow is the same:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">install</span><span class=\"token plain\"> </span><span class=\"token operator\" style=\"color:#393A34\">&lt;</span><span class=\"token plain\">repo</span><span class=\"token operator\" style=\"color:#393A34\">&gt;</span><span class=\"token plain\">    </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Add skills</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><span class=\"token plain\">              </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Push to tools</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare check             </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Detect updates</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare update </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--all</span><span class=\"token plain\">      </span><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Apply updates</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"resources\">Resources<a href=\"https://skillshare.runkids.cc/blog/team-sharing-patterns#resources\" class=\"hash-link\" aria-label=\"Direct link to Resources\" title=\"Direct link to Resources\" translate=\"no\">​</a></h2>\n<ul>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/how-to/sharing/organization-sharing\">Organization sharing guide</a></li>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/how-to/sharing/project-setup\">Project setup guide</a></li>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/how-to/sharing/hub-index\">Hub index guide</a></li>\n</ul>",
            "url": "https://skillshare.runkids.cc/blog/team-sharing-patterns",
            "title": "3 Patterns for Team Skill Sharing",
            "summary": "Every team eventually faces the question: \"How do we share AI skills across the team?\" Here are three patterns, from simplest to most structured, with skillshare handling the mechanics.",
            "date_modified": "2026-02-26T00:00:00.000Z",
            "author": {
                "name": "runkids",
                "url": "https://github.com/runkids"
            },
            "tags": [
                "team",
                "tutorial"
            ]
        },
        {
            "id": "https://skillshare.runkids.cc/blog/write-your-first-skill",
            "content_html": "<p>Skills are just Markdown files with frontmatter. If you can write a README, you can write a skill. Here's how to create one from scratch, audit it, and share it.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"what-is-a-skill\">What Is a Skill?<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#what-is-a-skill\" class=\"hash-link\" aria-label=\"Direct link to What Is a Skill?\" title=\"Direct link to What Is a Skill?\" translate=\"no\">​</a></h2>\n<p>A skill is a <code>SKILL.md</code> file inside a named directory. It contains instructions that AI coding tools (Claude Code, Cursor, Codex, etc.) load as context when working on your code.</p>\n<div class=\"language-text codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-text codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">my-skill/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">└── SKILL.md</span><br></span></code></pre></div></div>\n<p>That's the minimum. The <code>SKILL.md</code> file has two parts: frontmatter (metadata) and body (the actual instructions).</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-1-scaffold-with-skillshare-new\">Step 1: Scaffold with <code>skillshare new</code><a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#step-1-scaffold-with-skillshare-new\" class=\"hash-link\" aria-label=\"Direct link to step-1-scaffold-with-skillshare-new\" title=\"Direct link to step-1-scaffold-with-skillshare-new\" translate=\"no\">​</a></h2>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare new my-code-review</span><br></span></code></pre></div></div>\n<p>This creates <code>~/.config/skillshare/skills/my-code-review/SKILL.md</code> with a template:</p>\n<div class=\"language-markdown codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-markdown codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block punctuation\" style=\"color:#393A34\">---</span><span class=\"token front-matter-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block\"></span><span class=\"token front-matter-block front-matter yaml language-yaml key atrule\" style=\"color:#00a4db\">name</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">:</span><span class=\"token front-matter-block front-matter yaml language-yaml\"> my</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">-</span><span class=\"token front-matter-block front-matter yaml language-yaml\">code</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">-</span><span class=\"token front-matter-block front-matter yaml language-yaml\">review</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><span class=\"token front-matter-block front-matter yaml language-yaml key atrule\" style=\"color:#00a4db\">description</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">:</span><span class=\"token front-matter-block front-matter yaml language-yaml\"> </span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">&gt;</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">-</span><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block front-matter yaml language-yaml\">  Describe what this skill does. Use when user asks to</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block front-matter yaml language-yaml\">  \"trigger phrase 1\"</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">,</span><span class=\"token front-matter-block front-matter yaml language-yaml\"> </span><span class=\"token front-matter-block front-matter yaml language-yaml string\" style=\"color:#e3116c\">\"trigger phrase 2\"</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">,</span><span class=\"token front-matter-block front-matter yaml language-yaml\"> or needs help</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block front-matter yaml language-yaml\">  with a specific task.</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><span class=\"token front-matter-block front-matter yaml language-yaml comment\" style=\"color:#999988;font-style:italic\"># targets: []           # e.g. [claude, cursor] — omit for all targets</span><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><span class=\"token front-matter-block front-matter yaml language-yaml comment\" style=\"color:#999988;font-style:italic\"># metadata:</span><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><span class=\"token front-matter-block front-matter yaml language-yaml comment\" style=\"color:#999988;font-style:italic\">#   author: Your Name</span><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><span class=\"token front-matter-block front-matter yaml language-yaml comment\" style=\"color:#999988;font-style:italic\">#   version: 1.0.0</span><span class=\"token front-matter-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block\"></span><span class=\"token front-matter-block punctuation\" style=\"color:#393A34\">---</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token title important punctuation\" style=\"color:#393A34\">#</span><span class=\"token title important\"> My Code Review</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">Brief overview of what this skill does and its value.</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-2-write-the-instructions\">Step 2: Write the Instructions<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#step-2-write-the-instructions\" class=\"hash-link\" aria-label=\"Direct link to Step 2: Write the Instructions\" title=\"Direct link to Step 2: Write the Instructions\" translate=\"no\">​</a></h2>\n<p>Replace the template body with clear, actionable instructions. Good skills are:</p>\n<ul>\n<li class=\"\"><strong>Specific</strong> — tell the AI exactly what to do, not vague guidelines</li>\n<li class=\"\"><strong>Scoped</strong> — one skill, one concern (code review, testing, commit messages)</li>\n<li class=\"\"><strong>Contextual</strong> — explain when to apply the instructions</li>\n</ul>\n<p>Here's an example code review skill:</p>\n<div class=\"language-markdown codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-markdown codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block punctuation\" style=\"color:#393A34\">---</span><span class=\"token front-matter-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block\"></span><span class=\"token front-matter-block front-matter yaml language-yaml key atrule\" style=\"color:#00a4db\">name</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">:</span><span class=\"token front-matter-block front-matter yaml language-yaml\"> my</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">-</span><span class=\"token front-matter-block front-matter yaml language-yaml\">code</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">-</span><span class=\"token front-matter-block front-matter yaml language-yaml\">review</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><span class=\"token front-matter-block front-matter yaml language-yaml key atrule\" style=\"color:#00a4db\">description</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">:</span><span class=\"token front-matter-block front-matter yaml language-yaml\"> </span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">&gt;</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">-</span><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block front-matter yaml language-yaml\">  Enforce team code review standards. Check for security</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">,</span><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block front-matter yaml language-yaml\">  error handling</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">,</span><span class=\"token front-matter-block front-matter yaml language-yaml\"> input validation</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">,</span><span class=\"token front-matter-block front-matter yaml language-yaml\"> and style compliance.</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block front-matter yaml language-yaml\"></span><span class=\"token front-matter-block front-matter yaml language-yaml key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">:</span><span class=\"token front-matter-block front-matter yaml language-yaml\"> </span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">[</span><span class=\"token front-matter-block front-matter yaml language-yaml\">claude</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">,</span><span class=\"token front-matter-block front-matter yaml language-yaml\"> cursor</span><span class=\"token front-matter-block front-matter yaml language-yaml punctuation\" style=\"color:#393A34\">]</span><span class=\"token front-matter-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token front-matter-block\"></span><span class=\"token front-matter-block punctuation\" style=\"color:#393A34\">---</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token title important punctuation\" style=\"color:#393A34\">#</span><span class=\"token title important\"> Code Review Standards</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">When reviewing code (PR reviews, code suggestions, refactoring):</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token title important punctuation\" style=\"color:#393A34\">##</span><span class=\"token title important\"> Must Check</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token list punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> No hardcoded secrets or credentials</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token list punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> Error handling for all external calls (API, DB, file I/O)</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token list punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> Input validation at system boundaries</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token list punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> Tests for new public functions</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token title important punctuation\" style=\"color:#393A34\">##</span><span class=\"token title important\"> Style</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token list punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> Functions under 30 lines</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token list punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> No more than 3 parameters per function</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token list punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> Early returns over nested conditionals</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token list punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> Descriptive variable names (no single letters except loop counters)</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token title important punctuation\" style=\"color:#393A34\">##</span><span class=\"token title important\"> Response Format</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token list punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> List issues by severity: critical &gt; warning &gt; suggestion</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token list punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> Include file path and line number for each issue</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token list punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> Suggest fixes, don't just flag problems</span><br></span></code></pre></div></div>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-3-security-scan\">Step 3: Security Scan<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#step-3-security-scan\" class=\"hash-link\" aria-label=\"Direct link to Step 3: Security Scan\" title=\"Direct link to Step 3: Security Scan\" translate=\"no\">​</a></h2>\n<p>Before sharing, audit your skill:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare audit</span><br></span></code></pre></div></div>\n<p>This checks for patterns that could be harmful: prompt injection, data exfiltration, destructive commands. Even well-intentioned skills can accidentally trigger these patterns.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-4-sync-and-test\">Step 4: Sync and Test<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#step-4-sync-and-test\" class=\"hash-link\" aria-label=\"Direct link to Step 4: Sync and Test\" title=\"Direct link to Step 4: Sync and Test\" translate=\"no\">​</a></h2>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">sync</span><br></span></code></pre></div></div>\n<p>Now open your AI tool and test the skill. Ask it to review some code and check whether it follows your instructions.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"step-5-share\">Step 5: Share<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#step-5-share\" class=\"hash-link\" aria-label=\"Direct link to Step 5: Share\" title=\"Direct link to Step 5: Share\" translate=\"no\">​</a></h2>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"option-a-commit-to-a-shared-repo\">Option A: Commit to a shared repo<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#option-a-commit-to-a-shared-repo\" class=\"hash-link\" aria-label=\"Direct link to Option A: Commit to a shared repo\" title=\"Direct link to Option A: Commit to a shared repo\" translate=\"no\">​</a></h3>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token comment\" style=\"color:#999988;font-style:italic\"># Copy to a team repository</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token function\" style=\"color:#d73a49\">cp</span><span class=\"token plain\"> </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-r</span><span class=\"token plain\"> ~/.config/skillshare/skills/my-code-review /path/to/team-skills/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token builtin class-name\">cd</span><span class=\"token plain\"> /path/to/team-skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token function\" style=\"color:#d73a49\">git</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:#d73a49\">add</span><span class=\"token plain\"> my-code-review/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token function\" style=\"color:#d73a49\">git</span><span class=\"token plain\"> commit </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-m</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"Add code review skill\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token function\" style=\"color:#d73a49\">git</span><span class=\"token plain\"> push</span><br></span></code></pre></div></div>\n<p>Team members install with:</p>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare </span><span class=\"token function\" style=\"color:#d73a49\">install</span><span class=\"token plain\"> your-org/team-skills </span><span class=\"token parameter variable\" style=\"color:#36acaa\">--skill</span><span class=\"token plain\"> my-code-review</span><br></span></code></pre></div></div>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"option-b-project-scoped-skill\">Option B: Project-scoped skill<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#option-b-project-scoped-skill\" class=\"hash-link\" aria-label=\"Direct link to Option B: Project-scoped skill\" title=\"Direct link to Option B: Project-scoped skill\" translate=\"no\">​</a></h3>\n<div class=\"language-bash codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-bash codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token builtin class-name\">cd</span><span class=\"token plain\"> your-project</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">skillshare init </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-p</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token function\" style=\"color:#d73a49\">cp</span><span class=\"token plain\"> </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-r</span><span class=\"token plain\"> ~/.config/skillshare/skills/my-code-review .skillshare/skills/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token function\" style=\"color:#d73a49\">git</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:#d73a49\">add</span><span class=\"token plain\"> .skillshare/</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token function\" style=\"color:#d73a49\">git</span><span class=\"token plain\"> commit </span><span class=\"token parameter variable\" style=\"color:#36acaa\">-m</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"Add project code review skill\"</span><br></span></code></pre></div></div>\n<p>Anyone who clones the repo gets the skill automatically.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"controlling-where-skills-sync\">Controlling Where Skills Sync<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#controlling-where-skills-sync\" class=\"hash-link\" aria-label=\"Direct link to Controlling Where Skills Sync\" title=\"Direct link to Controlling Where Skills Sync\" translate=\"no\">​</a></h2>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"per-skill-target-restriction\">Per-skill target restriction<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#per-skill-target-restriction\" class=\"hash-link\" aria-label=\"Direct link to Per-skill target restriction\" title=\"Direct link to Per-skill target restriction\" translate=\"no\">​</a></h3>\n<p>Add a <code>targets</code> field to SKILL.md frontmatter to limit which AI tools receive this skill:</p>\n<div class=\"language-yaml codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-yaml codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token punctuation\" style=\"color:#393A34\">---</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token key atrule\" style=\"color:#00a4db\">name</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> claude</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">only</span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\">skill</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token key atrule\" style=\"color:#00a4db\">description</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> Only syncs to Claude Code</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> </span><span class=\"token punctuation\" style=\"color:#393A34\">[</span><span class=\"token plain\">claude</span><span class=\"token punctuation\" style=\"color:#393A34\">]</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"></span><span class=\"token punctuation\" style=\"color:#393A34\">---</span><br></span></code></pre></div></div>\n<p>Skills without a <code>targets</code> field sync to <strong>all</strong> configured targets.</p>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"per-target-filtering\">Per-target filtering<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#per-target-filtering\" class=\"hash-link\" aria-label=\"Direct link to Per-target filtering\" title=\"Direct link to Per-target filtering\" translate=\"no\">​</a></h3>\n<p>In your config, use <code>include</code>/<code>exclude</code> patterns to control which skills each target receives:</p>\n<div class=\"language-yaml codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-yaml codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token key atrule\" style=\"color:#00a4db\">targets</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">claude</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.claude/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">exclude</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"experimental-*\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">  </span><span class=\"token key atrule\" style=\"color:#00a4db\">cursor</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">    </span><span class=\"token key atrule\" style=\"color:#00a4db\">skills</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">path</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"> ~/.cursor/skills</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">      </span><span class=\"token key atrule\" style=\"color:#00a4db\">include</span><span class=\"token punctuation\" style=\"color:#393A34\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"coding-*\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:#393A34\">-</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:#e3116c\">\"review-*\"</span><br></span></code></pre></div></div>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"skillignore-for-repositories\"><code>.skillignore</code> for repositories<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#skillignore-for-repositories\" class=\"hash-link\" aria-label=\"Direct link to skillignore-for-repositories\" title=\"Direct link to skillignore-for-repositories\" translate=\"no\">​</a></h3>\n<p>If you publish a skill repository, add a <code>.skillignore</code> file to exclude internal/test skills from installation:</p>\n<div class=\"language-text codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#393A34;--prism-background-color:#f6f8fa\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-text codeBlock_bY9V thin-scrollbar\" style=\"color:#393A34;background-color:#f6f8fa\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\"># .skillignore — skills to exclude during install</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">internal-testing</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">experimental</span><br></span><span class=\"token-line\" style=\"color:#393A34\"><span class=\"token plain\">debug-*</span><br></span></code></pre></div></div>\n<p>Patterns support exact names, group prefixes, and trailing wildcards.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"tips-for-effective-skills\">Tips for Effective Skills<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#tips-for-effective-skills\" class=\"hash-link\" aria-label=\"Direct link to Tips for Effective Skills\" title=\"Direct link to Tips for Effective Skills\" translate=\"no\">​</a></h2>\n<ol>\n<li class=\"\"><strong>Keep the description under 1024 characters</strong> — Codex enforces this limit</li>\n<li class=\"\"><strong>Use headers for structure</strong> — AI tools parse Markdown headers for context</li>\n<li class=\"\"><strong>Be imperative</strong> — \"Check for X\" not \"It would be good to check for X\"</li>\n<li class=\"\"><strong>Include examples</strong> — Show the AI what good output looks like</li>\n<li class=\"\"><strong>Use <code>targets</code> to scope</strong> — Not every skill makes sense for every tool</li>\n</ol>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"resources\">Resources<a href=\"https://skillshare.runkids.cc/blog/write-your-first-skill#resources\" class=\"hash-link\" aria-label=\"Direct link to Resources\" title=\"Direct link to Resources\" translate=\"no\">​</a></h2>\n<ul>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/how-to/daily-tasks/creating-skills\">Creating skills guide</a></li>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/understand/skill-format\">Skill format reference</a></li>\n<li class=\"\"><a class=\"\" href=\"https://skillshare.runkids.cc/docs/how-to/daily-tasks/best-practices\">Best practices</a></li>\n</ul>",
            "url": "https://skillshare.runkids.cc/blog/write-your-first-skill",
            "title": "Writing Your First Skill: A Step-by-Step Guide",
            "summary": "Skills are just Markdown files with frontmatter. If you can write a README, you can write a skill. Here's how to create one from scratch, audit it, and share it.",
            "date_modified": "2026-02-26T00:00:00.000Z",
            "author": {
                "name": "runkids",
                "url": "https://github.com/runkids"
            },
            "tags": [
                "skill-authoring",
                "tutorial"
            ]
        }
    ]
}