Shesha Plugins

Welcome to the Shesha Plugins repository! This open-source project provides a collection of custom commands and plugins for Shesha, designed to extend functionality and streamline your development workflow.

Overview

Shesha Plugins is an extensible skills framework that allows developers to create and share custom skills for Claude. Skills are documentation-based guides that help automate tasks, standardize processes, and share best practices across your team. Whether you're setting up .NET analyzers, configuring authentication, or establishing coding standards, this repository provides a simple way to package and distribute your knowledge.

Getting Started

Prerequisites

Before you begin, ensure you have:

Claude CLI installed
Git installed on your machine
Basic understanding of Markdown (for creating skill documentation)

Installation

Via Claude Plugin Marketplace

The easiest way to install Shesha Plugins is through the Claude plugin marketplace:

Add the plugin to the marketplace
```
/plugin marketplace add ./
```
Open the marketplace
- Run: /plugin enter
- Use the arrow keys to navigate to the Marketplace tab
Navigate to Shesha Plugins
- Scroll down or search for "Shesha Plugins"
Browse available plugins
- Click "Browse Plugins" to see all available commands
Install for your team
- Click "Install for all collaborators" to make plugins available to your entire team

Creating Custom Skills

Skills allow you to extend Shesha's functionality with custom commands and workflows. Here's how to create your own:

Skill Structure

Each skill is a folder containing a SKILL.md file with metadata and instructions:

skills/
└── your-skill-name/
    └── SKILL.md

Step-by-Step Guide

Navigate to the skills directory
```
cd skills
```
Create a new folder for your skill
```
mkdir your-skill-name
```
Naming conventions:
- Use lowercase with hyphens (e.g., add-analyzers, setup-authentication)
- Make it descriptive and specific
- Avoid generic names
Create the SKILL.md file
```
cd your-skill-name
touch SKILL.md
```

Add frontmatter and content

Every SKILL.md file must start with YAML frontmatter containing the skill metadata:

---
name: your-skill-name
description: Brief description of what this skill does and when to use it
---

# Your Skill Title

Detailed documentation of your skill...

Skill Template

Here's a complete template for creating a new skill:

---
name: your-skill-name
description: Use this skill to [describe the main purpose and when to trigger this skill]
---

# Skill Title

Brief overview of what this skill accomplishes.

## Overview

Explain what the skill does and what problems it solves.

## Step 1: [First Step Title]

Detailed instructions for the first step.

# Example commands

command-example

## Step 2: [Second Step Title]

Continue with additional steps as needed.

### Important Notes

- Any special considerations
- Prerequisites or requirements
- Common pitfalls to avoid

## Example Usage

Provide concrete examples of how to use this skill.

---

Best Practices

Clear naming: Use descriptive frontmatter names and descriptions
Be specific: Clearly define when and how to use the skill
Step-by-step: Break down complex tasks into numbered steps
Include examples: Show real code snippets and commands
Document prerequisites: List any required tools or setup
Use code blocks: Format commands and code properly with syntax highlighting

Running the Project

Using Skills in Claude

Once installed via the marketplace, skills are automatically available in Claude:

Trigger skills naturally - Claude will automatically use relevant skills based on your requests
Browse available skills - Use the marketplace to see all installed skills
Share with team - Skills installed for all collaborators are immediately available

Local Development

If you're developing skills locally:

# Navigate to the project
cd shesha-plugins

# Add to Claude's plugin marketplace
/plugin marketplace add ./

# Your skills are now available in Claude

Contributing

We welcome contributions from the community! Here's how you can help:

How to Contribute

Fork the repository

git clone https://github.com/your-username/shesha-plugins.git

Create a feature branch
```
git checkout -b feature/new-skill-name
```

Create your skill

cd skills
mkdir your-new-skill
cd your-new-skill
touch SKILL.md

Commit your changes

git add .
git commit -m "Add [skill-name] skill for [purpose]"

Push to your fork
```
git push origin feature/new-skill-name
```
Open a Pull Request
- Describe what your skill does and when to use it
- Include examples of the skill in action
- Reference any related issues

Contribution Guidelines

Follow the skill template structure
Use clear, descriptive frontmatter
Include step-by-step instructions
Provide code examples where applicable
Test your skill before submitting
Update documentation as needed
Be respectful and collaborative

Project Structure

├── .claude/
│   ├── settings.json
│   └── settings.local.json
├── .claude-plugin/
│   └── marketplace.json
└── plugins/
    └── shesha-developer/
        ├── .claude-plugin/
        │   └── plugin.json
        └── skills/

Troubleshooting

Common Issues

Plugin not showing in marketplace

Ensure you've run /plugin marketplace add ./ from the project root directory
Verify you're in the correct directory (should contain the skills folder)
Refresh the marketplace view

Skill not being triggered

Check that your SKILL.md frontmatter is properly formatted with name and description
Ensure the description clearly indicates when the skill should be used
Verify the skill is installed for all collaborators

SKILL.md not recognized

Verify the file is named exactly SKILL.md (case-sensitive)
Check that YAML frontmatter is properly formatted with --- delimiters
Ensure the skill folder is directly under the skills directory

Made with ❤️ by the Shesha community

For questions or support, please open an issue or reach out to our community channels.

Name	create-entity
Description	Use this skill when creating entities and database migrations in .NET applications using the Shesha framework. This skill guides you through implementing Domain-Driven Design (DDD) patterns with comprehensive knowledge of Shesha best practices, entity modeling and migrations.

create-entity

SKILL.md