@trendai-crem/claude-skills 1.4.0 → 1.5.0

package/README.md

@@ -8,13 +8,14 @@ One-command Claude Code skill installer for the team. Installs curated AI agent
 npx @trendai-crem/claude-skills
 ```
 
-That's it. The command installs all three source types declared in `sources.json`:
+That's it. The command installs all four source types declared in `sources.json`:
 
 | Source type | What it installs | How to change |
 |-------------|-----------------|---------------|
+| **rules-dir** | Team-shared rules to `~/.claude/rules/team/` (loaded in every session) | Add/remove `rules/<name>.md`, bump version, PR |
 | **skills-repo** | [superpowers](https://github.com/obra/superpowers) — brainstorming, debugging, TDD, and more | Edit `sources.json`, bump version, PR |
 | **skills-dir** | Team skills in this repo's `skills/` directory | Add/remove `skills/<name>/`, bump version, PR |
-| **marketplace** | Plugins from `ai-skill-marketplace`, `claude-plugins-official`, and `openai-codex` | Edit `plugins` list in `sources.json`, bump version, PR |
+| **marketplace** | Plugins from `ai-skill-marketplace`, `claude-plugins-official`, `openai-codex`, and `everything-claude-code` | Edit `plugins` list in `sources.json`, bump version, PR |
 
 Re-run to update everything:
 
@@ -24,6 +25,14 @@ npx @trendai-crem/claude-skills@latest
 
 Auto-update runs at session start — you'll be notified when a new version is available and it installs automatically.
 
+## Team Rules (`rules/`)
+
+Rules are `.md` files installed to `~/.claude/rules/team/` and automatically loaded in every Claude session across all projects. Use rules for team-wide conventions that should always apply.
+
+| Rule | Description |
+|------|-------------|
+| **confluence-editing** | Use `atlassian-tools` skill for Confluence edits — never use raw MCP update tools |
+
 ## Team Skills (`skills/`)
 
 | Skill | Trigger | Description |
@@ -49,6 +58,16 @@ Installed from [ai-skill-marketplace](https://github.com/trend-ai-taskforce/ai-s
 
 ## For Maintainers
 
+### Adding a team rule
+
+1. Create a branch: `git checkout -b feat/add-<rule-name>`
+2. Add `rules/<rule-name>.md` (plain markdown, no frontmatter needed)
+3. Keep rules short (<50 lines) — they consume context window in every session
+4. Bump version: `npm version patch`
+5. Commit, push, open a PR, merge — CI publishes automatically
+
+Rules are always overwritten on install (not no-clobber) to stay in sync with the repo.
+
 ### Adding a team skill
 
 1. Create a branch: `git checkout -b feat/add-<skill-name>`
@@ -178,9 +197,13 @@ sources.json
     ↓
 cli.js (thin orchestrator)
     ↓
-lib/handlers/{skills-dir, skills-repo, marketplace}.js
+lib/handlers/{rules-dir, skills-dir, skills-repo, marketplace}.js
     ↓
 ~/.claude/claude-skills-manifest.json  (tracks what's installed)
+    ↓
+~/.claude/rules/team/     ← rules-dir handler
+~/.claude/skills/         ← skills-dir, skills-repo handlers
+~/.claude/plugins/        ← marketplace handler
 ```
 
 Removals propagate automatically: remove an entry from `sources.json`, bump version, and the next auto-update uninstalls it for all team members.

package/cli.js

@@ -92,9 +92,11 @@ function installEccRules() {
   const eccRulesDir = join(eccMarketplace, 'rules');
   if (!existsSync(eccRulesDir)) return;
 
+  const ALLOWED_LANGS = new Set(['common', 'typescript', 'java', 'golang', 'python', 'swift']);
+
   const destDir = join(homedir(), '.claude', 'rules');
   const languages = readdirSync(eccRulesDir, { withFileTypes: true })
-    .filter(d => d.isDirectory())
+    .filter(d => d.isDirectory() && ALLOWED_LANGS.has(d.name))
     .map(d => d.name);
 
   let copied = 0;

package/lib/handlers/index.js

@@ -1,9 +1,11 @@
 import { skillsDirHandler } from './skills-dir.js';
 import { skillsRepoHandler } from './skills-repo.js';
 import { marketplaceHandler } from './marketplace.js';
+import { rulesDirHandler } from './rules-dir.js';
 
 // Use Object.create(null) to prevent prototype chain traversal on adversarial type values.
 export const HANDLERS = Object.create(null);
 HANDLERS['skills-dir']  = skillsDirHandler;
 HANDLERS['skills-repo'] = skillsRepoHandler;
 HANDLERS['marketplace'] = marketplaceHandler;
+HANDLERS['rules-dir']   = rulesDirHandler;

package/lib/handlers/rules-dir.js

@@ -0,0 +1,70 @@
+import { readdirSync, copyFileSync, mkdirSync, existsSync, unlinkSync, rmdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const DEST_DIR = join(homedir(), '.claude', 'rules', 'team');
+
+/**
+ * Handler for team-shared rules (type: "rules-dir").
+ * Copies .md files from <repo>/rules/ to ~/.claude/rules/team/.
+ */
+export const rulesDirHandler = {
+  /**
+   * Returns the set of rule file names in the source directory.
+   * @param {object} entry - Source entry (uses convention: <baseDir>/rules/).
+   * @param {string} baseDir - Repository base directory.
+   * @returns {Set<string>|null}
+   */
+  getDesired(entry, baseDir) {
+    const srcDir = join(baseDir, entry.path ?? 'rules');
+    try {
+      const names = readdirSync(srcDir)
+        .filter(f => f.endsWith('.md'))
+        .sort();
+      return new Set(names);
+    } catch (err) {
+      console.warn(`\nWARN: Cannot read rules directory "${srcDir}": ${err.message}`);
+      return null;
+    }
+  },
+
+  /**
+   * Copies rule .md files to ~/.claude/rules/team/.
+   * Always overwrites to keep rules in sync with the repo.
+   * @returns {Array<{label, action, ok}>}
+   */
+  install(entry, baseDir) {
+    const srcDir = join(baseDir, entry.path ?? 'rules');
+    mkdirSync(DEST_DIR, { recursive: true });
+
+    try {
+      const files = readdirSync(srcDir).filter(f => f.endsWith('.md'));
+      for (const file of files) {
+        copyFileSync(join(srcDir, file), join(DEST_DIR, file));
+      }
+      console.log(`\n  Rules installed to ${DEST_DIR}/ (${files.length} files)`);
+      return [{ label: entry.label, action: 'install-group', ok: true }];
+    } catch (err) {
+      console.error(`\nFailed: ${entry.label} (${err.message})`);
+      return [{ label: entry.label, action: 'install-group', ok: false }];
+    }
+  },
+
+  /**
+   * Removes stale rule files from ~/.claude/rules/team/.
+   * @param {string[]} staleItems - File names to remove.
+   * @returns {Array<{label, action, ok}>}
+   */
+  uninstall(staleItems) {
+    return staleItems.map(file => {
+      const dest = join(DEST_DIR, file);
+      try {
+        if (existsSync(dest)) unlinkSync(dest);
+        return { label: file, action: 'uninstall', ok: true };
+      } catch (err) {
+        console.error(`\nFailed to remove rule ${file}: ${err.message}`);
+        return { label: file, action: 'uninstall', ok: false };
+      }
+    });
+  },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trendai-crem/claude-skills",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Claude Code skills installer for the trendai-crem team",
   "license": "UNLICENSED",
   "repository": {
@@ -15,7 +15,8 @@
     "sources.json",
     "marketplace.json",
     "lib/",
-    "skills/"
+    "skills/",
+    "rules/"
   ],
   "type": "module",
   "engines": {

package/rules/confluence-editing.md

@@ -0,0 +1,20 @@
+# Confluence Editing
+
+When editing Confluence pages, ALWAYS use the `atlassian-tools` skill
+(confluence_cli.py retrieve → edit local .md → update --file).
+
+NEVER use `mcp__atlassian__updateConfluencePage` with markdown contentFormat — it loses
+diagrams, macros, panels, and other ADF elements.
+
+NEVER use `mcp__atlassian__updateConfluencePage` with ADF contentFormat for large pages —
+the body parameter has a size limit that truncates content.
+
+Correct workflow:
+1. `confluence_cli.py -o <project>/.atlassian retrieve <pageId>`
+2. Edit the local `.md` file (Mermaid = ```mermaid blocks, macros = <!-- confluence-macro --> comments)
+3. `confluence_cli.py -o <project>/.atlassian update <pageId> --file <path>.md`
+
+The atlassian-tools skill handles:
+- Bidirectional HTML↔Markdown conversion preserving all Confluence elements
+- Version conflict detection with auto patch-merge
+- Local caching for offline editing

package/sources.json

@@ -1,6 +1,11 @@
 {
   "version": 1,
   "sources": [
+    {
+      "type": "rules-dir",
+      "path": "./rules",
+      "label": "team-rules"
+    },
     {
       "type": "skills-dir",
       "path": "./skills",