acek-skills 1.0.0 → 1.0.2

package/README.md

@@ -65,8 +65,8 @@ Running `install` with no arguments walks you through three prompts:
   ◉ sf-testing
 
 ? Select the target IDE(s) / tool(s)
-  ◉ Claude Code — project (./.claude/skills/user)
-  ◯ Claude Code — global (~/.claude/skills/user)
+  ◉ Claude Code — project (./.claude/skills)
+  ◯ Claude Code — global (~/.claude/skills)
   ◯ Cursor (./.cursor/rules)
   ◯ Windsurf (./.windsurf/rules)
   ◯ GitHub Copilot (./.github/instructions)
@@ -122,8 +122,8 @@ The CLI prints a reminder after install if any placeholder was left unresolved.
 
 | Target | Destination | Trigger behavior |
 |---|---|---|
-| **Claude Code** (project) | `./.claude/skills/user/<skill>/SKILL.md` | Auto-triggered — Claude reads the `description` frontmatter and invokes the skill only when the task matches |
-| **Claude Code** (global) | `~/.claude/skills/user/<skill>/SKILL.md` | Same as above, applies across every project on your machine |
+| **Claude Code** (project) | `./.claude/skills/<skill>/SKILL.md` | Auto-triggered — Claude reads the `description` frontmatter and invokes the skill only when the task matches |
+| **Claude Code** (global) | `~/.claude/skills/<skill>/SKILL.md` | Same as above, applies across every project on your machine |
 | **Cursor** | `./.cursor/rules/<skill>.mdc` | Project rule (`alwaysApply: false`) — Cursor decides relevance from the `description` field |
 | **Windsurf** | `./.windsurf/rules/<skill>.md` | Cascade rule (`trigger: model_decision`) — same idea, Windsurf's own matching |
 | **GitHub Copilot** | `./.github/instructions/<skill>.instructions.md` | Custom instructions (`applyTo: "**"`) — applied repo-wide, no per-task trigger |
@@ -166,6 +166,11 @@ external systems.
 Apex classes, triggers, batch jobs, test classes, SOQL, LWC (HTML/JS/CSS), Aura components, and
 integration patterns. Covers governor limits, CRUD/FLS patterns, `@AuraEnabled` conventions, LWC
 brand tokens + version badges, and REST/SOAP callout patterns.
+
+> **Note:** its LWC section uses a custom `:host` brand-token block (`--brand`, `--r-sm`, etc.)
+> plus a mandatory version badge — a different, incompatible styling convention from
+> [`shaiden`](https://www.npmjs.com/package/shaiden) (SLDS 2 global hooks only). Don't install
+> both against the same component without reconciling the two first.
 </details>
 
 <details>

package/bin/cli.js

@@ -10,17 +10,28 @@ const target = args[1]; // optional: specific skill name, or "--all"
 
 const SKILLS_SRC = path.join(__dirname, '../skills');
 
+function printBanner() {
+	console.log(`\x1b[36m
+  ____  _  _____ _     _     ____
+ / ___|| |/ /_ _| |   | |   / ___|
+ \\___ \\| ' / | || |   | |   \\___ \\
+  ___) | . \\ | || |___| |___ ___) |
+ |____/|_|\\_\\___|_____|_____|____/\x1b[0m
+\x1b[2mSalesforce skills for Claude Code\x1b[0m
+`);
+}
+
 // Where each target/tool expects its instruction files, and how to format them.
 const TARGETS = {
 	'claude-project': {
-		label: 'Claude Code — project (./.claude/skills/user)',
-		dir: (cwd) => path.join(cwd, '.claude/skills/user'),
+		label: 'Claude Code — project (./.claude/skills)',
+		dir: (cwd) => path.join(cwd, '.claude/skills'),
 		format: 'claude',
 		selected: true,
 	},
 	'claude-global': {
-		label: 'Claude Code — global (~/.claude/skills/user)',
-		dir: () => path.join(os.homedir(), '.claude/skills/user'),
+		label: 'Claude Code — global (~/.claude/skills)',
+		dir: () => path.join(os.homedir(), '.claude/skills'),
 		format: 'claude',
 		selected: false,
 	},
@@ -46,9 +57,12 @@ const TARGETS = {
 
 // Copies a skill directory, substituting org-alias placeholders in any
 // Markdown file along the way (binary/other files are copied as-is).
-function copySkillDir(src, dest, aliases) {
+// `skip` excludes filenames at the top level (used to drop SKILL.md when
+// mirroring a skill's supporting files next to a converted rule file).
+function copySkillDir(src, dest, aliases, skip = new Set()) {
 	fs.mkdirSync(dest, { recursive: true });
 	for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+		if (skip.has(entry.name)) continue;
 		const srcPath = path.join(src, entry.name);
 		const destPath = path.join(dest, entry.name);
 		if (entry.isDirectory()) {
@@ -148,6 +162,20 @@ function installSkillToTarget(skillName, targetKey, cwd, aliases = {}) {
 		path.join(destDir, `${skillName}${EXT[targetDef.format]}`),
 		content,
 	);
+
+	// Carry over supporting files (e.g. references/) alongside the converted
+	// rule file — these tools don't have Claude Code's skill directory, so we
+	// mirror it as <skillName>/ next to the main rule file.
+	const skillDir = path.join(SKILLS_SRC, skillName);
+	const extras = fs.readdirSync(skillDir).filter((f) => f !== 'SKILL.md');
+	if (extras.length > 0) {
+		copySkillDir(
+			skillDir,
+			path.join(destDir, skillName),
+			aliases,
+			new Set(['SKILL.md']),
+		);
+	}
 }
 
 function aliasesFromEnv() {
@@ -171,6 +199,8 @@ function warnIfAliasesUnresolved(skillNames, aliases) {
 }
 
 async function runInteractiveInstall() {
+	printBanner();
+
 	let prompts;
 	try {
 		prompts = require('prompts');
@@ -254,6 +284,7 @@ async function runInteractiveInstall() {
 async function main() {
 	if (command === 'install') {
 		if (target === '--all') {
+			printBanner();
 			const available = listSkills();
 			const aliases = aliasesFromEnv();
 			for (const skill of available) {
@@ -264,6 +295,7 @@ async function main() {
 			);
 			warnIfAliasesUnresolved(available, aliases);
 		} else if (target) {
+			printBanner();
 			const available = listSkills();
 			if (!available.includes(target)) {
 				console.error(

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "acek-skills",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "Installable Claude Code skills for Salesforce development (admin, dev, BA, testing, devops, security review, data migration, ideation)",
 	"bin": {
 		"acek-skills": "bin/cli.js"
@@ -24,9 +24,10 @@
 	"license": "MIT",
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/AcekBecek16/acek-sf-skills.git"
+		"url": "git+https://github.com/AcekBecek16/acek-sf-skills.git",
+		"directory": "packages/acek-skills"
 	},
-	"homepage": "https://github.com/AcekBecek16/acek-sf-skills#readme",
+	"homepage": "https://github.com/AcekBecek16/acek-sf-skills/tree/master/packages/acek-skills#readme",
 	"bugs": {
 		"url": "https://github.com/AcekBecek16/acek-sf-skills/issues"
 	}