AI Coding Standards

A personal collection of AI prompts, operating modes, and rules designed to streamline development and ensure high-quality code through AI collaboration.

📁 Project Structure

• commands/: Markdown-based command definitions (e.g., spec-assistant.md) for use with slash commands.
• skills/: Agent Skills that can be installed in Cursor, VS Code (GitHub Copilot), or Claude Desktop for automatic activation.
  • spec-assistant/: A collaborative spec-building assistant that guides spec-driven development.

🚀 Installation

For Cursor IDE

Option 1: Install from GitHub (Recommended - UI Method)

The easiest way to install this skill is through Cursor's built-in GitHub integration:

1. Open Cursor Settings (Cmd+Shift+J on Mac, Ctrl+Shift+J on Windows/Linux)
2. Navigate to Rules
3. In the Project Rules section, click Add Rule
4. Select Remote Rule (Github)
5. Enter the repository URL: https://github.com/harshilparmar/ai-coding-standards
6. Cursor will automatically discover and load the skill from the skills/spec-assistant/ directory

Note: Agent Skills are currently only available in the Nightly release channel. To switch:

• Open Cursor Settings (Cmd+Shift+J / Ctrl+Shift+J)
• Select Beta
• Set your update channel to Nightly
• Restart Cursor after the update

For more details, see the official Cursor documentation on installing skills from GitHub.

Option 2: Clone the entire repository

# Clone the repository
git clone https://github.com/harshilparmar/ai-coding-standards.git

# Copy the skill to Cursor's skills directory
cp -r ai-coding-standards/skills/spec-assistant ~/.cursor/skills/

Option 3: Clone just the skill directory

# Navigate to Cursor skills directory
mkdir -p ~/.cursor/skills
cd ~/.cursor/skills

# Clone just the skill
git clone https://github.com/harshilparmar/ai-coding-standards.git temp-repo
cp -r temp-repo/skills/spec-assistant .
rm -rf temp-repo

Option 4: Download and extract manually

1. Download this repository as a ZIP file
2. Extract the skills/spec-assistant folder
3. Copy it to ~/.cursor/skills/spec-assistant

After installation (Options 2-4), restart Cursor. The skill will be automatically discovered and available.

Viewing installed skills:

• Open Cursor Settings → Rules
• Skills appear in the Agent Decides section

For VS Code (GitHub Copilot)

Note: Agent Skills support in VS Code is currently in preview. Enable the chat.useAgentSkills setting to use Agent Skills.

Option 1: Install as a project skill (Recommended)

Install the skill in your workspace so it's available for all team members:

# Clone the repository
git clone https://github.com/harshilparmar/ai-coding-standards.git

# Copy the skill to your project's .github/skills directory
mkdir -p .github/skills
cp -r ai-coding-standards/skills/spec-assistant .github/skills/

Option 2: Install as a personal skill

Install the skill in your user profile for use across all projects:

# Clone the repository
git clone https://github.com/harshilparmar/ai-coding-standards.git

# Copy the skill to your personal skills directory
mkdir -p ~/.copilot/skills
cp -r ai-coding-standards/skills/spec-assistant ~/.copilot/skills/

Option 3: Clone directly to skills directory

# For project-level installation
mkdir -p .github/skills
cd .github/skills
git clone https://github.com/harshilparmar/ai-coding-standards.git temp-repo
cp -r temp-repo/skills/spec-assistant .
rm -rf temp-repo

# Or for user-level installation
mkdir -p ~/.copilot/skills
cd ~/.copilot/skills
git clone https://github.com/harshilparmar/ai-coding-standards.git temp-repo
cp -r temp-repo/skills/spec-assistant .
rm -rf temp-repo

Enable Agent Skills in VS Code:

1. Open VS Code Settings (Cmd+, on Mac, Ctrl+, on Windows/Linux)
2. Search for chat.useAgentSkills
3. Enable the setting: "Chat: Use Agent Skills"
4. Restart VS Code

Legacy compatibility: VS Code also supports skills in .claude/skills/ (project-level) or ~/.claude/skills/ (user-level) for backward compatibility.

For more details, see the official VS Code documentation on Agent Skills.

For Claude Desktop

1. Download the skill as a ZIP file:

   # Clone the repository
   git clone https://github.com/harshilparmar/ai-coding-standards.git
   cd ai-coding-standards/skills
   
   # Create a ZIP file of the skill
   zip -r spec-assistant.zip spec-assistant/

2. Upload to Claude Desktop:

   • Open Claude Desktop
   • Go to Settings → Capabilities
   • In the Skills section, click "Upload skill"
   • Select the spec-assistant.zip file you created

For Claude Code (CLI)

# Clone the repository
git clone https://github.com/harshilparmar/ai-coding-standards.git

# Install the skill
/plugin add /path/to/ai-coding-standards/skills/spec-assistant

Or install from a directory:

cd ~/.claude/skills
git clone https://github.com/harshilparmar/ai-coding-standards.git temp-repo
cp -r temp-repo/skills/spec-assistant .
rm -rf temp-repo

Using Commands (Alternative)

If you prefer using slash commands instead of skills:

# For Cursor
cp commands/spec-assistant.md ~/.cursor/commands/

# For Claude Code
cp commands/spec-assistant.md ~/.claude/commands/

Then use: /spec-assistant in your IDE.

📖 Usage

Once installed, the spec-assistant skill activates automatically when you mention spec-related keywords like:

• "Help me spec out a new feature"
• "I need to build a specification"
• "Let's gather requirements"

See skills/spec-assistant/QUICK_START.md for detailed usage instructions.