@maccesar/titools 4.1.0 → 4.3.0

package/lib/commands/uninstall.js

@@ -16,6 +16,7 @@ import {
   removeSkillSymlinks,
   removeSkills,
   removeAgents,
+  removeCommands,
 } from '../cleanup.js';
 import checkbox, { Separator } from '../prompts/checkboxCancel.js';
 import {
@@ -25,8 +26,8 @@ import {
 } from '../utils.js';
 import { existsSync } from 'fs';
 import { join, resolve } from 'path';
-import { getAgentsSkillsDir, getClaudeAgentsDir } from '../config.js';
-import { getSkillList, getAgentList } from '../cleanup.js';
+import { getAgentsSkillsDir, getClaudeAgentsDir, getClaudeCommandsDir } from '../config.js';
+import { getSkillList, getAgentList, getCommandList } from '../cleanup.js';
 
 /**
  * Uninstall command handler
@@ -56,10 +57,13 @@ export async function uninstallCommand(options) {
 
   const skillList = getSkillList();
   const agentList = getAgentList().map((agent) => `${agent}.md`);
+  const commandList = getCommandList().map((command) => `${command}.md`);
   const homeSkillsDir = getAgentsSkillsDir();
   const projectSkillsDir = getAgentsSkillsDir(projectDir);
   const homeAgentsDir = getClaudeAgentsDir();
   const projectAgentsDir = getClaudeAgentsDir(projectDir);
+  const homeCommandsDir = getClaudeCommandsDir();
+  const projectCommandsDir = getClaudeCommandsDir(projectDir);
 
   const hasAnyInDir = (dir, names) =>
     !!dir && existsSync(dir) && names.some((name) => existsSync(join(dir, name)));
@@ -68,6 +72,8 @@ export async function uninstallCommand(options) {
   const hasProjectSkills = isProject && hasAnyInDir(projectSkillsDir, skillList);
   const hasHomeAgents = hasAnyInDir(homeAgentsDir, agentList);
   const hasProjectAgents = isProject && hasAnyInDir(projectAgentsDir, agentList);
+  const hasHomeCommands = hasAnyInDir(homeCommandsDir, commandList);
+  const hasProjectCommands = isProject && hasAnyInDir(projectCommandsDir, commandList);
 
   const hasHomeSymlinks = detectedPlatforms.some((platform) =>
     hasAnyInDir(platform.skillsDir, skillList)
@@ -80,6 +86,13 @@ export async function uninstallCommand(options) {
   if (hasHomeAgents || hasProjectAgents) {
     choices.push({ name: '`ti-pro` for Claude Code', value: 'agents', checked: true });
   }
+  if (hasHomeCommands || hasProjectCommands) {
+    choices.push({
+      name: 'Slash commands for Claude Code (`/ti-check`, `/ti-new-screen`, `/ti-audit`)',
+      value: 'commands',
+      checked: true,
+    });
+  }
   if (hasKnowledgeBlocks) {
     choices.push({ name: 'Knowledge index from context files', value: 'knowledge', checked: true });
   }
@@ -207,6 +220,23 @@ export async function uninstallCommand(options) {
     }
   }
 
+  if (targets.includes('commands')) {
+    spinner.start('Removing slash commands...');
+    const results = [];
+    results.push(removeCommands(undefined));
+    if (isProject) {
+      results.push(removeCommands(projectDir));
+    }
+
+    const removed = results.flatMap((r) => r.removed);
+    if (removed.length > 0) {
+      spinner.succeed(`${removed.length} slash command${removed.length !== 1 ? 's' : ''} removed`);
+      actionTaken = true;
+    } else {
+      spinner.info('No slash commands to remove');
+    }
+  }
+
   // Remove knowledge index blocks from project files
   if (targets.includes('knowledge')) {
     if (!isProject) {

package/lib/commands/update.js

@@ -18,6 +18,7 @@ import { cleanupLegacyArtifacts, getSkillList } from '../cleanup.js';
 import {
   installSkills,
   installAgents,
+  installCommands,
   getLocalRepoDir,
 } from '../installer.js';
 import { agentsCommand } from './agents.js';
@@ -72,6 +73,20 @@ async function performUpdate(baseDir, repoDir, spinner) {
     } else {
       spinner.info('No agents to sync');
     }
+
+    spinner.start('Syncing slash commands...');
+    const commandsResult = await installCommands(repoDir, baseDir);
+    if (commandsResult.installed.length > 0) {
+      spinner.succeed(
+        `${commandsResult.installed.length} slash command${commandsResult.installed.length !== 1 ? 's' : ''} synced`
+      );
+    } else if (commandsResult.skipped.length > 0) {
+      spinner.info(
+        `${commandsResult.skipped.length} slash command${commandsResult.skipped.length !== 1 ? 's' : ''} already provided by the marketplace plugin`
+      );
+    } else {
+      spinner.info('No slash commands to sync');
+    }
   }
 
   cleanupLegacyArtifacts(baseDir);

package/lib/config.js

@@ -54,15 +54,44 @@ export const LEGACY_AGENTS = [
   'ti-researcher',
 ];
 
+// Slash commands to install (Claude Code only — copied to ~/.claude/commands/)
+export const COMMANDS = [
+  'ti-check',
+  'ti-new-screen',
+  'ti-audit',
+];
+// Legacy commands to remove during updates/uninstall
+export const LEGACY_COMMANDS = [];
+
 // Directory paths
 export const getAgentsDir = (baseDir = os.homedir()) => path.join(baseDir, '.agents');
 export const getAgentsSkillsDir = (baseDir = os.homedir()) => path.join(getAgentsDir(baseDir), 'skills');
 export const getClaudeAgentsDir = (baseDir = os.homedir()) => path.join(baseDir, '.claude', 'agents');
 export const getClaudeSkillsDir = (baseDir = os.homedir()) => path.join(baseDir, '.claude', 'skills');
+export const getClaudeCommandsDir = (baseDir = os.homedir()) => path.join(baseDir, '.claude', 'commands');
 export const getGeminiSkillsDir = (baseDir = os.homedir()) => path.join(baseDir, '.gemini', 'skills');
 export const getCodexSkillsDir = (baseDir = os.homedir()) => path.join(baseDir, '.codex', 'skills');
 export const getConfigDir = () => path.join(os.homedir(), '.titools');
 
+// Name of the Claude marketplace and plugin where this CLI publishes itself.
+// Used to detect when a skill or command already reaches Claude Code through the
+// marketplace plugin, so the CLI does not install a second copy of it.
+export const CLAUDE_PLUGIN_MARKETPLACE = 'maccesar-titools';
+export const CLAUDE_PLUGIN_NAME = 'titools';
+export const getClaudePluginSkillsPath = (baseDir = os.homedir()) =>
+  path.join(baseDir, '.claude', 'plugins', 'cache', CLAUDE_PLUGIN_MARKETPLACE, CLAUDE_PLUGIN_NAME);
+
+// The key Claude Code writes under "enabledPlugins" when the plugin is installed.
+export const CLAUDE_PLUGIN_KEY = `${CLAUDE_PLUGIN_NAME}@${CLAUDE_PLUGIN_MARKETPLACE}`;
+
+// Where Claude Code records which plugins are enabled. Both files are consulted
+// because the local variant overrides the shared one, and either may carry the
+// entry depending on how the plugin was installed.
+export const getClaudeSettingsPaths = (baseDir = os.homedir()) => [
+  path.join(baseDir, '.claude', 'settings.json'),
+  path.join(baseDir, '.claude', 'settings.local.json'),
+];
+
 // AI platform detection
 //
 // Only platforms that need TiTools-managed symlinks appear here.
@@ -111,14 +140,22 @@ export default {
   LEGACY_SKILLS,
   AGENTS,
   LEGACY_AGENTS,
+  COMMANDS,
+  LEGACY_COMMANDS,
   getAgentsDir,
   getAgentsSkillsDir,
   getClaudeAgentsDir,
   getClaudeSkillsDir,
+  getClaudeCommandsDir,
   getGeminiSkillsDir,
   getCodexSkillsDir,
   getConfigDir,
   getPlatforms,
+  CLAUDE_PLUGIN_MARKETPLACE,
+  CLAUDE_PLUGIN_NAME,
+  CLAUDE_PLUGIN_KEY,
+  getClaudePluginSkillsPath,
+  getClaudeSettingsPaths,
   AI_FILE_PRIORITIES,
   TITANIUM_PROJECT_FILE,
   GITHUB_API_HEADERS,

package/lib/installer.js

@@ -15,10 +15,12 @@ import os from 'os';
 import {
   SKILLS,
   AGENTS,
+  COMMANDS,
   getAgentsSkillsDir,
   getClaudeAgentsDir,
+  getClaudeCommandsDir,
 } from './config.js';
-import { removeSkills, removeAgents } from './cleanup.js';
+import { removeSkills, removeAgents, removeCommands } from './cleanup.js';
 
 /**
  * Recursively copy a directory
@@ -170,6 +172,86 @@ export async function installAgents(repoDir, baseDir = os.homedir()) {
   return results;
 }
 
+/**
+ * Install a single slash command to the Claude commands directory
+ * @param {string} repoDir - Repository directory
+ * @param {string} commandName - Name of the command (without .md)
+ * @param {string} baseDir - Base directory for installation
+ * @returns {Promise<boolean>} True if installed successfully
+ */
+export async function installCommand(repoDir, commandName, baseDir = os.homedir()) {
+  const commandsDir = getClaudeCommandsDir(baseDir);
+  const src = join(repoDir, 'commands', `${commandName}.md`);
+  const dest = join(commandsDir, `${commandName}.md`);
+
+  if (!existsSync(commandsDir)) {
+    mkdirSync(commandsDir, { recursive: true });
+  }
+
+  if (!existsSync(src)) {
+    return false;
+  }
+
+  if (existsSync(dest)) {
+    await remove(dest);
+  }
+
+  copyFileSync(src, dest);
+  return true;
+}
+
+/**
+ * Install all slash commands to the Claude commands directory
+ * @param {string} repoDir - Repository directory
+ * @param {string} baseDir - Base directory for installation
+ * @returns {Promise<Object>} Results object with installed / failed / removed / skipped
+ */
+export async function installCommands(repoDir, baseDir = os.homedir()) {
+  const results = {
+    installed: [],
+    failed: [],
+    removed: [],
+    skipped: [],
+  };
+
+  const legacyLocal = removeCommands(baseDir, { legacyOnly: true });
+  results.removed.push(...legacyLocal.removed);
+  results.failed.push(...legacyLocal.failed);
+
+  if (baseDir && baseDir !== os.homedir()) {
+    const legacyGlobal = removeCommands(undefined, { legacyOnly: true });
+    results.removed.push(...legacyGlobal.removed);
+    results.failed.push(...legacyGlobal.failed);
+  }
+
+  const { pluginProvidesCommand } = await import('./claude-plugin.js');
+  const commandsDir = getClaudeCommandsDir(baseDir);
+
+  for (const cmd of COMMANDS) {
+    // Same rule the symlink step applies to skills: when the marketplace plugin
+    // already provides the command, installing our own copy makes it show up
+    // twice in the autocomplete. Clean up any copy left from before the plugin
+    // was installed.
+    if (pluginProvidesCommand(cmd, baseDir)) {
+      const stalePath = join(commandsDir, `${cmd}.md`);
+      if (existsSync(stalePath)) {
+        await remove(stalePath);
+        results.removed.push(cmd);
+      }
+      results.skipped.push(cmd);
+      continue;
+    }
+
+    if (await installCommand(repoDir, cmd, baseDir)) {
+      results.installed.push(cmd);
+    } else {
+      results.failed.push(cmd);
+    }
+  }
+
+  return results;
+}
+
 /**
  * Get the local repository directory if running from source
  * @returns {string|null} Local repo directory or null
@@ -191,5 +273,7 @@ export default {
   installSkills,
   installAgent,
   installAgents,
+  installCommand,
+  installCommands,
   getLocalRepoDir,
 };

package/lib/symlink.js

@@ -69,19 +69,44 @@ async function removePath(path) {
 }
 
 /**
- * Create symlinks for all skills to a platform directory
+ * Whether the marketplace plugin already provides this skill to Claude Code.
+ *
+ * Claude Code lists skills the plugin carries on its own, so an additional
+ * symlink at ~/.claude/skills/<skill> produces a duplicate entry in the
+ * autocomplete. This helper lets the symlink step skip Claude when the plugin
+ * already covers it.
+ *
+ * Requires the plugin to be *enabled*, not merely cached — see `claude-plugin.js`
+ * for why the distinction matters.
+ * @param {string} skillName - Skill name (e.g. 'ti-expert')
+ * @param {string} baseDir - Optional base directory (defaults to homedir via config)
+ * @returns {Promise<boolean>} True if the plugin provides this skill
+ */
+export async function isClaudePluginSkillInstalled(skillName, baseDir) {
+  const { pluginProvidesSkill } = await import('./claude-plugin.js');
+  return pluginProvidesSkill(skillName, baseDir);
+}
+
+/**
+ * Create symlinks for all skills to a platform directory.
+ * For the Claude platform, skills already provided by the maccesar-titools
+ * marketplace plugin are skipped to avoid duplicate entries; if a stale symlink
+ * from a previous install exists, it is removed.
  * @param {string} platformSkillsDir - Platform skills directory
  * @param {Array} skills - List of skill names
  * @param {string} baseDir - Optional base directory for target resolution
- * @returns {Promise<Object>} Results object with success/failure counts
+ * @returns {Promise<Object>} Results object with linked / failed / skipped arrays
  */
 export async function createSkillSymlinks(platformSkillsDir, skills, baseDir) {
-  const { getAgentsSkillsDir } = await import('./config.js');
+  const { getAgentsSkillsDir, getClaudeSkillsDir } = await import('./config.js');
   const agentsSkillsDir = getAgentsSkillsDir(baseDir);
+  const claudeSkillsDir = getClaudeSkillsDir(baseDir);
+  const isClaudePlatform = platformSkillsDir === claudeSkillsDir;
 
   const results = {
     linked: [],
     failed: [],
+    skipped: [],
   };
 
   // Ensure platform directory exists
@@ -93,6 +118,17 @@ export async function createSkillSymlinks(platformSkillsDir, skills, baseDir) {
   const useRelative = !!baseDir;
 
   for (const skill of skills) {
+    // Skip Claude when the marketplace plugin already provides this skill;
+    // clean up any stale symlink left from a previous CLI install.
+    if (isClaudePlatform && await isClaudePluginSkillInstalled(skill, baseDir)) {
+      const stalePath = join(platformSkillsDir, skill);
+      if (existsSync(stalePath)) {
+        await removePath(stalePath);
+      }
+      results.skipped.push(skill);
+      continue;
+    }
+
     const target = join(agentsSkillsDir, skill);
     const linkPath = join(platformSkillsDir, skill);
 
@@ -147,6 +183,7 @@ export async function updateSymlink(target, path) {
 
 export default {
   createSymlinkOrCopy,
+  isClaudePluginSkillInstalled,
   createSkillSymlinks,
   isSymlink,
   resolveSymlink,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maccesar/titools",
-  "version": "4.1.0",
+  "version": "4.3.0",
   "description": "Titanium SDK skills and agents for AI coding assistants (Claude Code, Gemini CLI, Codex CLI)",
   "main": "lib/index.js",
   "type": "module",
@@ -57,6 +57,7 @@
     "lib/",
     "skills/",
     "agents/",
+    "commands/",
     "AGENTS-VERCEL-RESEARCH.md"
   ],
   "publishConfig": {

package/skills/alloy-guides/references/MODELS.md

@@ -6,6 +6,29 @@ Models, collections, and how to bind them to views in Alloy. For sync adapters,
 2. [Alloy Collection and Model Objects](#alloy-collection-and-model-objects)
 3. [Alloy Data Binding](#alloy-data-binding)
 
+<!-- TOC-START -->
+## Contents
+
+- [Overview](#overview)
+- [Alloy Collection and Model Objects](#alloy-collection-and-model-objects)
+  - [Models](#models)
+  - [Collections](#collections)
+  - [Event Handling](#event-handling)
+- [Alloy Data Binding](#alloy-data-binding)
+  - [Introduction](#introduction)
+  - [Alloy Binding](#alloy-binding)
+  - [Collection vs Model Data Binding](#collection-vs-model-data-binding)
+  - [Global Singleton vs Local Instance](#global-singleton-vs-local-instance)
+  - [Simple vs Complex Data Binding](#simple-vs-complex-data-binding)
+  - [Backbone Binding](#backbone-binding)
+  - [Bind Deep Object Properties](#bind-deep-object-properties)
+  - [Use Models and Properties with Special Characters](#use-models-and-properties-with-special-characters)
+  - [Bind Multiple Models to the Same View](#bind-multiple-models-to-the-same-view)
+  - [Define Transformations in the Model](#define-transformations-in-the-model)
+  - [Tips and Tricks](#tips-and-tricks)
+
+<!-- TOC-END -->
+
 ## Overview
 
 Alloy uses Backbone.js to provide support for its models and collections. Alloy also borrows the concepts of migrations and adapters from Rails for storage integration.

package/skills/alloy-guides/references/MODELS_ADVANCED.md

@@ -6,6 +6,25 @@ Persistence, custom adapters, schema migrations, plain Backbone usage, and the B
 2. [Backbone Objects without Alloy](#backbone-objects-without-alloy)
 3. [Alloy Backbone Migration](#alloy-backbone-migration)
 
+<!-- TOC-START -->
+## Contents
+
+- [Alloy Sync Adapters and Migrations](#alloy-sync-adapters-and-migrations)
+  - [Sync Adapters](#sync-adapters)
+  - [Custom Sync Adapters](#custom-sync-adapters)
+  - [Migrations](#migrations)
+- [Backbone Objects without Alloy](#backbone-objects-without-alloy)
+  - [Using Backbone Objects with Alloy Data Binding](#using-backbone-objects-with-alloy-data-binding)
+- [Alloy Backbone Migration](#alloy-backbone-migration)
+  - [Overview](#overview)
+  - [Setup](#setup)
+  - [Summary of Changes](#summary-of-changes)
+  - [Parse Method](#parse-method)
+  - [Silent Option](#silent-option)
+  - [API Changes](#api-changes)
+
+<!-- TOC-END -->
+
 ## Alloy Sync Adapters and Migrations
 
 ### Sync Adapters

package/skills/alloy-guides/references/VIEWS_STYLES.md

@@ -1,5 +1,17 @@
 # Alloy Styles and Themes
 
+<!-- TOC-START -->
+## Contents
+
+- [Titanium Style Sheets](#titanium-style-sheets)
+- [Global Styles](#global-styles)
+- [Platform-Specific Styles](#platform-specific-styles)
+- [Custom Query Styles](#custom-query-styles)
+- [Themes](#themes)
+- [Style Priorities](#style-priorities)
+
+<!-- TOC-END -->
+
 ## Titanium Style Sheets
 
 The Titanium Style Sheets (TSS) file uses a JSON-like syntax to define the attributes of elements in the XML files. All TSS attributes are the properties of the Titanium object.

package/skills/alloy-guides/references/VIEWS_XML.md

@@ -1,5 +1,23 @@
 # Alloy XML Markup
 
+<!-- TOC-START -->
+## Contents
+
+- [Introduction](#introduction)
+- [Collection Element](#collection-element)
+- [Model Element](#model-element)
+- [Module Attribute](#module-attribute)
+- [Module Element](#module-element)
+- [Require Element](#require-element)
+- [Namespace](#namespace)
+- [Conditional Code](#conditional-code)
+- [Property Mapping](#property-mapping)
+- [Event Handling](#event-handling)
+- [Data Binding](#data-binding)
+- [Non-Standard Syntax](#non-standard-syntax)
+
+<!-- TOC-END -->
+
 ## Introduction
 
 In Alloy, the XML markup abstracts the Titanium SDK UI components, so you do not need to code the creation and setup of these components using JavaScript and the Titanium SDK API. All view files must be placed in the `app/views` folder of your project with the `.xml` file extension.

package/skills/purgetss/references/EXAMPLES.md

@@ -2,6 +2,30 @@
 
 Complete examples of common patterns with anti-patterns and correct implementations.
 
+<!-- TOC-START -->
+## Contents
+
+- [Community-Discovered Patterns](#community-discovered-patterns)
+  - [Titanium Layout Patterns](#titanium-layout-patterns)
+  - [Horizontal Row with Space Between](#horizontal-row-with-space-between)
+  - [Centered Content (Vertically and Horizontally)](#centered-content-vertically-and-horizontally)
+  - [Vertical Stack with Spacing](#vertical-stack-with-spacing)
+  - [Header with Left/Right Elements](#header-with-leftright-elements)
+  - [Available Layout Classes](#available-layout-classes)
+  - [Manual .tss Files Anti-Pattern](#manual-tss-files-anti-pattern)
+  - [Grid with Percentages](#grid-with-percentages)
+  - [Gap Usage](#gap-usage)
+  - [Padding on Container Views](#padding-on-container-views)
+  - [`w-full` vs `w-screen`](#w-full-vs-w-screen)
+  - [`rounded-full` Without Size](#rounded-full-without-size)
+  - [Square Brackets for Arbitrary Values](#square-brackets-for-arbitrary-values)
+  - [Layout Defaults](#layout-defaults)
+  - [ScrollView Without `content-w-screen` / `content-h-auto`](#scrollview-without-content-w-screen-content-h-auto)
+  - [Deprecated `theme.View.DEFAULT` vs `theme.extend.View`](#deprecated-themeviewdefault-vs-themeextendview)
+  - [Quick Reference Table](#quick-reference-table)
+
+<!-- TOC-END -->
+
 ## Community-Discovered Patterns
 
 The examples below catalog anti-patterns observed in real Titanium + PurgeTSS projects, paired with the correct approach. They are not exhaustive rules from official docs — they reflect pitfalls the community has hit often enough to warrant dedicated guidance.

package/skills/purgetss/references/animation-advanced.md

@@ -6,6 +6,18 @@ For core animation methods (play, toggle, apply, open, close, draggable, undragg
 
 ---
 
+<!-- TOC-START -->
+## Contents
+
+- [Property Inheritance from the Animation Object](#property-inheritance-from-the-animation-object)
+- [Timing and Utility Classes](#timing-and-utility-classes)
+- [Utility Functions](#utility-functions)
+- [Implementation Rules](#implementation-rules)
+- [Method Implementation Template](#method-implementation-template)
+- [Complex UI Example](#complex-ui-example)
+
+<!-- TOC-END -->
+
 ## Property Inheritance from the Animation Object
 
 All methods in the Animation module inherit properties from the `<Animation>` object's classes. You configure animation behavior in XML and it applies to every method call.

package/skills/purgetss/references/animation-system.md

@@ -1,5 +1,28 @@
 # PurgeTSS Animation System
 
+<!-- TOC-START -->
+## Contents
+
+- [Introduction](#introduction)
+- [Methods Reference (All 15)](#methods-reference-all-15)
+- [Modifiers](#modifiers)
+- [The `play` Method](#the-play-method)
+- [Callback Event Object](#callback-event-object)
+- [The `apply` Method](#the-apply-method)
+- [The `open` and `close` Methods](#the-open-and-close-methods)
+- [The `draggable` Method](#the-draggable-method)
+- [The `undraggable` Method](#the-undraggable-method)
+- [The `detectCollisions` Method](#the-detectcollisions-method)
+- [The `sequence` Method](#the-sequence-method)
+- [The `swap` Method](#the-swap-method)
+- [The `pulse` Method](#the-pulse-method)
+- [The `shake` Method](#the-shake-method)
+- [The `snapTo` Method](#the-snapto-method)
+- [The `reorder` Method](#the-reorder-method)
+- [The `transition` Method](#the-transition-method)
+
+<!-- TOC-END -->
+
 ## Introduction
 
 PurgeTSS includes an Animation module for 2D Matrix animations and transformations. It works on single elements, arrays of elements, or individual children of an element.

package/skills/purgetss/references/app-branding.md

@@ -9,6 +9,29 @@ For the terse flag reference, see the [`brand` command reference](./cli-commands
 > The `brand` command at a glance
 > `purgetss brand` turns one logo into every asset a Titanium app needs to ship — launcher icons, adaptive icons, iOS 18+ Dark/Tinted variants, marketplace artwork, and optional notification/splash icons. Works on both Alloy and Classic projects.
 
+<!-- TOC-START -->
+## Contents
+
+- [Quick start](#quick-start)
+- [The `purgetss/brand/` convention](#the-purgetssbrand-convention)
+- [The `brand:` config section (v7.7.0 grouped structure)](#the-brand-config-section-v770-grouped-structure)
+- [Overwrite confirmation](#overwrite-confirmation)
+- [What gets generated](#what-gets-generated)
+- [Android dark mode](#android-dark-mode)
+- [Android 12+ splash artwork](#android-12-splash-artwork)
+- [Android legacy splash fallback](#android-legacy-splash-fallback)
+- [iOS 18+ Dark and Tinted variants](#ios-18-dark-and-tinted-variants)
+- [Google Play Feature Graphic (v7.10.0)](#google-play-feature-graphic-v7100)
+- [Brand color](#brand-color)
+- [Padding guidance](#padding-guidance)
+- [Cleanup legacy branding artifacts](#cleanup-legacy-branding-artifacts)
+- [Troubleshooting](#troubleshooting)
+- [Full flag reference](#full-flag-reference)
+- [Community-Discovered Patterns](#community-discovered-patterns)
+- [See also](#see-also)
+
+<!-- TOC-END -->
+
 ## Quick start
 
 Drop a logo file into `purgetss/brand/`, then run the command. That's the whole workflow.

package/skills/purgetss/references/apply-directive.md

@@ -1,5 +1,22 @@
 # The `apply` Directive
 
+<!-- TOC-START -->
+## Contents
+
+- [Create Complex Classes and IDs](#create-complex-classes-and-ids)
+- [Set Any ID, Class, or Ti Element](#set-any-id-class-or-ti-element)
+- [Use Default Classes](#use-default-classes)
+- [Use Icon Font Classes (v7.10.0)](#use-icon-font-classes-v7100)
+- [Use Arbitrary Values](#use-arbitrary-values)
+- [Use Newly Defined Classes in `config.cjs`](#use-newly-defined-classes-in-configcjs)
+- [Set a String of Classes or an Array of Classes](#set-a-string-of-classes-or-an-array-of-classes)
+- [Combine with Platform, Device, or Conditional Blocks](#combine-with-platform-device-or-conditional-blocks)
+- [Customizing Window, View, and ImageView](#customizing-window-view-and-imageview)
+- [Platform-Specific Classes](#platform-specific-classes)
+- [Community-Discovered Patterns](#community-discovered-patterns)
+
+<!-- TOC-END -->
+
 ## Create Complex Classes and IDs
 
 > **INFO**

package/skills/purgetss/references/arbitrary-values.md

@@ -7,6 +7,19 @@ When you need a one-off value that is not in the defaults, use arbitrary values
 >
 > Square bracket notation (`[10px]`) is **not supported** because Titanium handles platform and conditional statements in `.tss` files differently. Use parentheses (`(10px)`) instead.
 
+<!-- TOC-START -->
+## Contents
+
+- [Class syntax pre-validation](#class-syntax-pre-validation)
+- [Arbitrary nesting depth in `theme` objects (v7.10.0)](#arbitrary-nesting-depth-in-theme-objects-v7100)
+- [Color Properties](#color-properties)
+- [Spacing Properties](#spacing-properties)
+- [Miscellaneous Properties](#miscellaneous-properties)
+- [Examples](#examples)
+- [Community-Discovered Patterns](#community-discovered-patterns)
+
+<!-- TOC-END -->
+
 ## Class syntax pre-validation
 
 Starting with PurgeTSS v7.8.0, the build runs a pre-validation pass over class names found in XML views and JS controllers before purging. When it spots a malformed arbitrary-value utility, it stops and prints a structured `Class Syntax Error` block so the offending class can be fixed before any TSS is generated. If multiple errors are present, all of them are reported in the same run.

package/skills/purgetss/references/class-index-properties.md

@@ -4,6 +4,17 @@ Full A–Z table of every Titanium property and its PurgeTSS class prefix. Split
 
 > Before suggesting ANY class, verify it exists: `grep -E "PATTERN" ./purgetss/styles/utilities.tss`
 
+<!-- TOC-START -->
+## Contents
+
+- [All 416 Titanium Properties with Classes](#all-416-titanium-properties-with-classes)
+  - [A-E](#a-e)
+  - [F-L](#f-l)
+  - [M-P](#m-p)
+  - [R-Z](#r-z)
+
+<!-- TOC-END -->
+
 ## All 416 Titanium Properties with Classes
 
 The following properties have PurgeTSS utility classes. Each property name converts to kebab-case for the class prefix.