basics

by nityeshagav1.5.1

Essential commands, agents, hooks, and skills for everyday development workflows

Installation guide →

6 skills 15 commandshooks GitHub

Commands

cc

Commit changes

cleanup

You are a senior Rails developer tasked with reviewing a branch of code with extreme attention to architectural and code quality issues. Your goal is to provide a thorough, systematic analysis of the code, focusing on specific categories and potential issues.

compound

What should Claude learn from this session?

create-developer-doc

I want you to deeply study the codebase to understand how this works:

create-pitch

Create a 37 signals style "pitches" for this new feature we wanna build in Cora:

depcheck

Please analyze pull request #$ARGUMENTS opened by dependabot. Check the release notes for any changes that might break existing application. Basically determine if it's safe to merge Dependabot's changes. Make sure to review the full Gemfile.lock diff, reviewing version bumps in transitive depend...

gem-upgrade

I want to upgrade #$ARGUMENTS. I need you to check the release notes and commits to make a report on how it would affect my application, including what changes I should make before/after upgrading.

help-me-write

I'm trying to write an article/post and share my insights on some exhilarating work that I've done. So I want to capture it and share it because I'm really excited.

interview-me

I want you to start a timer in the background and just interview me. Do a little discovery call with me so that you can learn more about me and what I'm trying to do here.

logically-commit

Commit after every logically complete unit of work

pinpoint

Investigate the exact cause of this problem and pinpoint the issue to be before suggesting a solution:

review

Review this branch objectively and without any biases. Think ultrahard and do a detailed review across each of these parameters one by one.

schedule-claude

Help the user set up a scheduled Claude Code job on macOS for: **$ARGUMENTS**

study

Can you study the changes that have happened in this branch and deeply understand what we're working on currently? I'm asking because you'll need that knowledge to successfully work on the task i'm about to give you next.

tidy-commits

Organize the changes made into commits so that it's easy for me to review.

Documentation

# Basics

Essential Claude Code commands, agents, hooks, and skills for everyday development workflows.

## Installation

1. Run `/plugin` to open the plugin manager
2. Go to **Marketplaces** tab (use Tab to cycle)
3. Select **+ Add Marketplace** → enter `nityeshaga/claude-code-essentials`
4. Go to **Discover** tab and select **basics** to install

## Commands

| Command | Description |
|---------|-------------|
| `/cc` | Commit changes |
| `/cleanup` | Rails code review with architecture and quality analysis |
| `/compound` | Reflect on session learnings and extract tacit knowledge |
| `/create-developer-doc` | Generate developer documentation |
| `/create-pitch` | Create 37signals-style pitch for new features |
| `/depcheck` | Analyze Dependabot PRs for safe merging |
| `/gem-upgrade` | Analyze gem upgrade impact with release notes and commits |
| `/logically-commit` | Commit after every logically complete unit of work |
| `/pinpoint` | Investigate and pinpoint root cause before suggesting solutions |
| `/review` | Objective branch review for code smells and unintended changes |
| `/study` | Study branch changes to understand current work context |
| `/tidy-commits` | Organize changes into reviewable commits |

## Agents

| Agent | Description |
|-------|-------------|
| `dhh-reviewer` | DHH-style code reviewer providing brutally honest Rails code review |

## Hooks

| Hook | Description |
|------|-------------|
| `block-main-push` | Prevents accidental git pushes to the main branch |

### About block-main-push

This hook prevents Claude from accidentally pushing to `main` branch when running in bypassPermissions mode. It intercepts git push commands and blocks:
- Explicit pushes to main
- Implicit pushes when on main branch
- Cross-repository pushes via `-C` flag

**Related: [safe-push plugin](../safe-push/README.md)**

The same hook is available as a standalone plugin called `safe-push`. Use:

- **basics** (this plugin): For **project-level** installation in CI/CD environments (e.g., GitHub Actions)
- **safe-push**: For **user-level** installation to protect local development across all repositories

See the [safe-push README](../safe-push/README.md) for details on the vulnerability this prevents.

## Skills

| Skill | Description |
|-------|-------------|
| `ai-tool-designer` | Designing tools for AI agents with agent-centric design principles |
| `dhh-rails-expert` | Writing and reviewing Rails code following DHH's style |
| `kamal-deploy` | Expert-level Kamal deployment guidance for containerized apps |
| `mcp-builder` | MCP (Model Context Protocol) server development guide |
| `prompt-engineer` | Prompt engineering for AI systems |
| `skill-creator` | Guide for creating Claude skills |