@karedo-hq/agent-skills

Centralized agent skills and rules for our engineering team. Install shared configurations for AI-powered IDEs like Cursor, Claude Code, and more.

Installation

# Using pnpm
pnpm dlx @karedo-hq/agent-skills install --target cursor

# Or install globally
pnpm add -g @karedo-hq/agent-skills
agent-skills install --target cursor

Usage

Install Configurations

Install agent configurations to your current project:

agent-skills install --target <ide>

Options:

• -t, --target <ide> - Target IDE (required). Currently supported: cursor
• -f, --force - Overwrite existing files without prompting

Examples:

# Install Cursor configurations
agent-skills install --target cursor

# Force overwrite existing files
agent-skills install --target cursor --force

Updating

When skills or rules are updated, developers can get the latest version:

# Get latest from npm
pnpm dlx @karedo-hq/agent-skills@latest install --target cursor --force

# Or directly from GitHub (always pulls latest main)
pnpm dlx github:karedo-hq/agent-skills install --target cursor --force

The --force flag overwrites existing files with the new versions.

Supported Targets

| Target | Description | Output Directory | | -------- | --------------------------- | ---------------- | | cursor | Cursor IDE rules and skills | .cursor/ |

What Gets Installed

Rules

Always-applied rules that are active in every context:

• TypeScript - General TypeScript coding standards

Skills

Skills are agent-requestable guidelines and reusable workflows. They are discovered by the AI based on their description and invoked when relevant.

Backend

• nestjs - General NestJS guidelines for our backend development
• controllers - How to define API controllers on the backend
• services - How to define injectable services on the backend
• dtos - How to define DTOs (data-transfer-objects) on the backend
• mongodb-schemas - How to define our DB schemas on the backend
• tiptap-templates - How to define Tiptap templates on the backend
• mail-from-template - How to implement email sending from HTML templates on the backend
• s3-file-storage - How to name S3 object keys when uploading files on the backend
• scripts - How to define one-off CLI scripts on the backend (NestJS injectable, plan/result JSON output, dry-run + confirmation flow)

Frontend

• nextjs - General Next.js guidelines for our frontend development
• pages - How to create pages on the frontend
• forms - How to implement forms on the frontend
• tables - How to implement table components on the frontend
• data-fetching-and-server-actions - How to handle frontend data-fetching and actions
• responsive-dialog-drawer - How to make a dialog-based component responsive for mobile

Product

• write-pitch - Shape feature ideas into de-risked pitches with rabbit-hole analysis and Linear-ready scopes

Workflows

• commit - Commit current work with conventional commits
• create-pr - Create a pull request with proper formatting
• deslop - Remove AI-generated code slop
• release - Automate the release process
• address-pr-comments - Address PR comments
• publish-to-agents - Publish to @karedo-hq/agent-skills npm via git tag
• update-ebo-java - Upgrade the ebo-java service to a new Governikus Vibilia REST Edition vendor release

Development

# Install dependencies
pnpm install

# Build
pnpm build

# Watch mode
pnpm dev

# Type check
pnpm typecheck

Adding New Skills or Rules

1. Skills: Create a new directory under skills/<skill-name>/ with a SKILL.md file containing frontmatter (name, description) and the skill body
2. Rules: Add always-applied rules to rules/ (use .mdc extension for Cursor compatibility)
3. Bump version in package.json
4. Commit and tag: git tag [email protected]
5. Push with tags: git push && git push --tags
6. GitHub Actions automatically publishes to npm

Adding New IDE Targets

1. Create a new handler in src/targets/<ide-name>.ts
2. Register it in src/targets/index.ts
3. Implement the install function that maps rules/ and skills/ to the IDE's expected location

License

MIT