<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/development/how-to/enable-the-internal-pack/">
  <id>https://docs.spec-kitty.ai/development/how-to/enable-the-internal-pack/</id>
  <title>How to enable the internal charter and skills</title>
  <updated>2026-10-08T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/development/how-to/enable-the-internal-pack/"/>
  <summary>Register the internal org pack in your clone, project the four kitty-* maintainer skills into each tool, verify them, and work around two known defects.</summary>
  <content type="html">&lt;span id=&quot;how-to-enable-the-internal-charter-and-skills&quot;&gt;&lt;/span&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;packs/internal/&lt;/code&gt; holds the doctrine that governs how the core team works, plus four
shared maintainer skills: &lt;code dir=&quot;auto&quot;&gt;kitty-land-pr&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;kitty-issue-triage&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;kitty-mission-from-issue&lt;/code&gt;
and &lt;code dir=&quot;auto&quot;&gt;kitty-report-debrief&lt;/code&gt;. The pack never ships to consumers. This page gets it working in
your clone.&lt;/p&gt;
&lt;h2 id=&quot;step-1-register-the-pack&quot;&gt;Step 1: Register the pack&lt;/h2&gt;
&lt;p&gt;Add the pack to &lt;code dir=&quot;auto&quot;&gt;.kittify/config.yaml&lt;/code&gt; as an org pack:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;charter_packs&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;org&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;packs&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;    &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;- &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;internal&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;      &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;local_path&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;packs/internal&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;This is the canonical shape. This repository’s own config already carries the entry.&lt;/p&gt;
&lt;p&gt;The pack’s &lt;code dir=&quot;auto&quot;&gt;org-charter.yaml&lt;/code&gt; sets &lt;code dir=&quot;auto&quot;&gt;skill_namespace: kitty&lt;/code&gt; and lists all four skills in
&lt;code dir=&quot;auto&quot;&gt;required_skills&lt;/code&gt;, so registering the pack puts them in force. You do not run
&lt;code dir=&quot;auto&quot;&gt;spec-kitty charter activate skill&lt;/code&gt; for them.&lt;/p&gt;
&lt;h2 id=&quot;step-2-project-the-skills&quot;&gt;Step 2: Project the skills&lt;/h2&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;mkdir&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;-p&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;.claude&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;   &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# only if `claude` is a configured tool and .claude/ is missing (#4275)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;upgrade&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;The &lt;code dir=&quot;auto&quot;&gt;SKILL.md&lt;/code&gt; files are not on disk until &lt;code dir=&quot;auto&quot;&gt;upgrade&lt;/code&gt; writes them into each configured tool’s
project skill root. See the root table in
&lt;a href=&quot;/development/how-to/create-a-pack-skill/#step-3-activate-it&quot;&gt;Create and activate a pack skill&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;step-3-verify&quot;&gt;Step 3: Verify&lt;/h2&gt;
&lt;p&gt;Check that each tool’s project skill root holds the four directories, for example:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;ls&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;.claude/skills&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;.agents/skills&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;|&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;grep&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;kitty-&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;You should see &lt;code dir=&quot;auto&quot;&gt;kitty-land-pr&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;kitty-issue-triage&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;kitty-mission-from-issue&lt;/code&gt; and
&lt;code dir=&quot;auto&quot;&gt;kitty-report-debrief&lt;/code&gt;, each with a &lt;code dir=&quot;auto&quot;&gt;SKILL.md&lt;/code&gt;. Do not rely on
&lt;code dir=&quot;auto&quot;&gt;spec-kitty doctor skills&lt;/code&gt; for this check (see below).&lt;/p&gt;
&lt;h2 id=&quot;known-defects&quot;&gt;Known defects&lt;/h2&gt;




















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Symptom&lt;/th&gt;&lt;th&gt;Cause&lt;/th&gt;&lt;th&gt;Workaround&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;upgrade&lt;/code&gt; fails with “Owner effect conflict” on &lt;code dir=&quot;auto&quot;&gt;.claude&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;claude&lt;/code&gt; is configured and the clone has no &lt;code dir=&quot;auto&quot;&gt;.claude/&lt;/code&gt; directory (#4275)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;mkdir .claude&lt;/code&gt;, then run &lt;code dir=&quot;auto&quot;&gt;upgrade&lt;/code&gt; again. Projects that do not configure &lt;code dir=&quot;auto&quot;&gt;claude&lt;/code&gt; are not affected.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;doctor skills&lt;/code&gt; reports healthy but a &lt;code dir=&quot;auto&quot;&gt;kitty-*&lt;/code&gt; directory is missing&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;doctor skills&lt;/code&gt; does not notice a pack skill in force that was never projected, and &lt;code dir=&quot;auto&quot;&gt;--fix&lt;/code&gt; does not project it (#5801)&lt;/td&gt;&lt;td&gt;Check the directories yourself after &lt;code dir=&quot;auto&quot;&gt;upgrade&lt;/code&gt;, as in Step 3.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;after-pulling-the-change-that-untracked-the-command-skill-ledger&quot;&gt;After pulling the change that untracked the command-skill ledger&lt;/h2&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;.kittify/command-skills-manifest.json&lt;/code&gt; is a per-machine ledger and is no longer tracked. Pulling
the change that untracked it deletes your local copy, and &lt;code dir=&quot;auto&quot;&gt;spec-kitty doctor skills --fix&lt;/code&gt; then
refuses because it sees unmanaged files. Do this once:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;rm&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;-rf&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;.agents/skills/spec-kitty.&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;*&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;doctor&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;skills&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--fix&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;upgrade&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;The first command removes the generated &lt;code dir=&quot;auto&quot;&gt;spec-kitty.*&lt;/code&gt; command-skill directories. The &lt;code dir=&quot;auto&quot;&gt;fix&lt;/code&gt;
rebuilds the ledger, and &lt;code dir=&quot;auto&quot;&gt;upgrade&lt;/code&gt; projects the &lt;code dir=&quot;auto&quot;&gt;kitty-*&lt;/code&gt; skills.&lt;/p&gt;
&lt;h2 id=&quot;see-also&quot;&gt;See also&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty-open-packs/blob/main/packs/internal/README.md&quot;&gt;Internal pack README&lt;/a&gt;: what the pack contains.&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/development/how-to/create-a-pack-skill/&quot;&gt;Create and activate a pack skill&lt;/a&gt;: author your own skill.&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/org-doctrine-layer/&quot;&gt;Understanding the Org Layer of the Charter Offering&lt;/a&gt;: how a project registers a pack.&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
