Skip to content

chore: use skills instead of rules #16

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
strausr wants to merge 1 commit into
base: main
Choose a base branch
from
Open

chore: use skills instead of rules #16

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
106 changes: 61 additions & 45 deletions cli.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
import { fileURLToPath } from 'url';
import { dirname, join } from 'path';
import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
import { spawnSync } from 'child_process';
import { spawnSync, spawn } from 'child_process';
import inquirer from 'inquirer';
import chalk from 'chalk';
import fs from 'fs-extra';
Expand Down Expand Up @@ -208,12 +208,14 @@ async function main() {
name: 'aiTools',
message:
'Which AI coding assistant(s) are you using? (Select all that apply)\n' +
chalk.gray(' We’ll add local instruction files so your assistant knows Cloudinary patterns.\n'),
chalk.gray(' We\'ll install Cloudinary skills in the right location for each tool.\n'),
choices: [
{ name: 'Cursor', value: 'cursor' },
{ name: 'GitHub Copilot', value: 'copilot' },
{ name: 'Claude Code', value: 'claude' },
{ name: 'Other / Generic AI tools', value: 'generic' },
{ name: 'GitHub Copilot', value: 'copilot' },
{ name: 'OpenAI Codex', value: 'codex' },
{ name: 'Gemini CLI', value: 'gemini' },
{ name: 'Other', value: 'generic' },
],
default: ['cursor'],
},
Expand Down Expand Up @@ -316,35 +318,59 @@ async function main() {
copyTemplate(file);
});

// Create AI rules based on user's tool selection
const aiRulesTemplatePath = join(TEMPLATES_DIR, '.cursorrules.template');
if (existsSync(aiRulesTemplatePath) && aiTools && aiTools.length > 0) {
const aiRulesContent = replaceTemplate(
readFileSync(aiRulesTemplatePath, 'utf-8'),
templateVars
);
// Install Cloudinary skills into the directories each selected tool actually reads:
// .cursor/skills/ = Cursor
// .claude/skills/ = Claude Code
// .agents/skills/ = Copilot, Codex, Gemini, Generic (and any unrecognised tool)
console.log(chalk.blue('\n🤖 Installing Cloudinary AI skills...\n'));

const skillTargetDirs = new Set();
if (aiTools && aiTools.includes('cursor')) skillTargetDirs.add(join(projectPath, '.cursor', 'skills'));
if (aiTools && aiTools.includes('claude')) skillTargetDirs.add(join(projectPath, '.claude', 'skills'));
if (!aiTools || aiTools.some(t => !['cursor', 'claude'].includes(t))) {
skillTargetDirs.add(join(projectPath, '.agents', 'skills'));
}

// Generate files based on selected tools
if (aiTools.includes('cursor')) {
writeFileSync(join(projectPath, '.cursorrules'), aiRulesContent);
}
const skills = ['cloudinary-docs', 'cloudinary-react', 'cloudinary-transformations'];
// Download each skill once then copy to any additional targets
const [primaryDir, ...additionalDirs] = skillTargetDirs;
mkdirSync(primaryDir, { recursive: true });

if (aiTools.includes('copilot')) {
const githubDir = join(projectPath, '.github');
mkdirSync(githubDir, { recursive: true });
writeFileSync(join(githubDir, 'copilot-instructions.md'), aiRulesContent);
}
// Print all skill names upfront so the user sees activity immediately
for (const skill of skills) {
console.log(chalk.gray(` Fetching ${skill}...`));
}

if (aiTools.includes('claude')) {
writeFileSync(join(projectPath, 'CLAUDE.md'), aiRulesContent);
// Download all 3 skills in parallel
const results = await Promise.all(
skills.map(skill => new Promise(resolve => {
const proc = spawn(
'npx',
['--yes', 'degit', `cloudinary-devs/skills/skills/${skill}`, join(primaryDir, skill)],
{ stdio: 'pipe', shell: false }
);
proc.on('close', code => resolve({ skill, ok: code === 0 }));
}))
);

let skillsInstalled = 0;
for (const { skill, ok } of results) {
if (ok) {
console.log(chalk.gray(` ✓ ${skill}`));
skillsInstalled++;
} else {
console.warn(chalk.yellow(` ⚠ Could not install ${skill} (check your internet connection)`));
}
}

if (aiTools.includes('generic')) {
writeFileSync(join(projectPath, 'AI_INSTRUCTIONS.md'), aiRulesContent);
writeFileSync(join(projectPath, 'PROMPT.md'), aiRulesContent);
if (skillsInstalled > 0) {
for (const target of additionalDirs) {
fs.copySync(primaryDir, target);
}
}

// Generate MCP configuration: Cursor uses .cursor/mcp.json, Claude Code uses .mcp.json in project root
// Generate MCP configuration: Cursor uses .cursor/mcp.json, Claude Code uses .mcp.json in project root
if (aiTools && aiTools.length > 0) {
const mcpTemplatePath = join(TEMPLATES_DIR, '.cursor/mcp.json.template');
if (existsSync(mcpTemplatePath)) {
const mcpContent = replaceTemplate(
Expand All @@ -370,25 +396,15 @@ async function main() {

console.log(chalk.green('✅ Project created successfully!\n'));

if (aiTools && aiTools.length > 0) {
// Count actual files created
let fileCount = 0;
if (aiTools.includes('cursor')) fileCount += 2; // .cursorrules + mcp.json
if (aiTools.includes('copilot')) fileCount += 1;
if (aiTools.includes('claude')) fileCount += 2; // CLAUDE.md + .mcp.json
if (aiTools.includes('generic')) fileCount += 2; // AI_INSTRUCTIONS.md + PROMPT.md

const filesText = fileCount === 1 ? 'file' : 'files';
console.log(chalk.cyan(`📋 AI assistant configuration ${filesText} created:`));
if (aiTools.includes('cursor')) console.log(chalk.gray(' • Cursor: .cursorrules'));
if (aiTools.includes('copilot')) console.log(chalk.gray(' • GitHub Copilot: .github/copilot-instructions.md'));
if (aiTools.includes('claude')) console.log(chalk.gray(' • Claude: CLAUDE.md'));
if (aiTools.includes('generic')) console.log(chalk.gray(' • Generic: AI_INSTRUCTIONS.md, PROMPT.md'));
if (aiTools.includes('cursor')) console.log(chalk.gray(' • MCP (Cursor): .cursor/mcp.json'));
if (aiTools.includes('claude')) console.log(chalk.gray(' • MCP (Claude Code): .mcp.json'));
console.log(chalk.gray(`\n ${fileCount === 1 ? 'This file teaches' : 'These files teach'} your AI assistant about Cloudinary patterns and best practices.`));
console.log(chalk.gray(`\n 💡 How to use ${fileCount === 1 ? 'this file' : 'these files'}:`));
console.log(chalk.gray(' • Simply open your project in your AI assistant - the configuration is already loaded'));
if (skillsInstalled > 0) {
console.log(chalk.cyan(`\n📋 AI skills installed → .agents/skills/ (works with Cursor, Claude Code, Copilot, and more):`));
console.log(chalk.gray(' • cloudinary-docs — looks up live Cloudinary documentation'));
console.log(chalk.gray(' • cloudinary-react — React SDK patterns and best practices'));
console.log(chalk.gray(' • cloudinary-transformations — describe image & video edits in plain English'));
if (aiTools && aiTools.includes('cursor')) console.log(chalk.gray(' • MCP (Cursor): .cursor/mcp.json'));
if (aiTools && aiTools.includes('claude')) console.log(chalk.gray(' • MCP (Claude Code): .mcp.json'));
console.log(chalk.gray('\n 💡 How to use:'));
console.log(chalk.gray(' • Open your project in your AI assistant — skills are picked up automatically'));
console.log(chalk.gray(' • Ask your AI to help build Cloudinary features, and it will follow these patterns'));
console.log(chalk.gray(' • Example prompts: "Add image upload", "Create a transformation gallery"\n'));
}
Expand Down
Loading