Back to Skills

best-practices

verified

View and manage your personal best practices library with success/failure patterns. Use when viewing best practices, checking patterns, reviewing success/failure history.

View on GitHub

Marketplace

orchestkit

yonatangross/orchestkit

Plugin

ork

development

Repository

yonatangross/orchestkit
33stars

plugins/ork/skills/best-practices/SKILL.md

Last Verified

January 25, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/yonatangross/orchestkit/blob/main/plugins/ork/skills/best-practices/SKILL.md -a claude-code --skill best-practices

Installation paths:

Claude
.claude/skills/best-practices/
Powered by add-skill CLI

Instructions

# Best Practices - View Your Pattern Library

Display your aggregated best practices library, showing successful patterns and anti-patterns across all projects.

## Usage

```
/best-practices                     # Show full library
/best-practices <category>          # Filter by category
/best-practices --warnings          # Show only anti-patterns
/best-practices --successes         # Show only successes
/best-practices --stats             # Show statistics only
```

## Options

- `<category>` - Filter by specific category (pagination, database, authentication, etc.)
- `--warnings` - Show only anti-patterns (failed patterns)
- `--successes` - Show only successful patterns
- `--stats` - Show statistics summary without individual patterns

## Workflow

### 1. Query mem0 for Best Practices

Use `mcp__mem0__search_memories` with:

```json
{
  "query": "patterns outcomes",
  "filters": {
    "OR": [
      { "metadata.outcome": "success" },
      { "metadata.outcome": "failed" }
    ]
  },
  "limit": 100
}
```

### 2. Aggregate Results

Group patterns by category, then by outcome:

```json
{
  "pagination": {
    "successes": [...],
    "failures": [...]
  },
  "authentication": {
    "successes": [...],
    "failures": [...]
  }
}
```

### 3. Calculate Statistics

For each pattern:
- Count occurrences across projects
- Calculate success rate: successes / (successes + failures)
- Note which projects contributed

### 4. Display Output

**Full Library View:**
```
๐Ÿ“š Your Best Practices Library
โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

PAGINATION
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
  โœ… Cursor-based pagination (3 projects, always worked)
     "Scales well for large datasets"

  โŒ Offset pagination (failed in 2 projects)
     "Caused timeouts on tables with 1M+ rows"
     ๐Ÿ’ก Lesson: Use cursor-based for large datasets

AUTHENTICATION
โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
  โœ… JWT + httpOnly refresh tokens

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
4186 chars