oh-my-customcode 0.12.1 → 0.12.3

package/templates/.codex/skills/fastapi-best-practices/SKILL.md

@@ -1,270 +0,0 @@
----
-name: fastapi-best-practices
-description: FastAPI patterns for high-performance async APIs
-user-invocable: false
----
-
-## Purpose
-
-Apply FastAPI patterns for building high-performance async APIs.
-
-## Rules
-
-### 1. Project Structure
-
-```yaml
-structure:
-  domain_based: true
-  module_contents:
-    - router.py: API endpoints
-    - schemas.py: Pydantic models
-    - models.py: Database models
-    - service.py: Business logic
-    - dependencies.py: Route validators
-    - constants.py: Module constants
-    - config.py: Module configuration
-    - exceptions.py: Custom exceptions
-    - utils.py: Helper functions
-
-imports:
-  style: explicit
-  example: "from src.auth import constants as auth_constants"
-
-layout: |
-  src/
-  ├── auth/
-  │   ├── router.py
-  │   ├── schemas.py
-  │   ├── models.py
-  │   ├── service.py
-  │   └── dependencies.py
-  ├── users/
-  │   └── ...
-  ├── config.py
-  └── main.py
-```
-
-### 2. Async Patterns
-
-```yaml
-io_intensive:
-  use: "async def"
-  await: "asyncio.sleep(), httpx, asyncpg, etc."
-  example: |
-    async def fetch_data():
-        async with httpx.AsyncClient() as client:
-            response = await client.get(url)
-            return response.json()
-
-sync_io:
-  use: "def (regular function)"
-  reason: FastAPI offloads to threadpool automatically
-  example: |
-    def read_file():
-        with open('file.txt') as f:
-            return f.read()
-
-cpu_intensive:
-  avoid: async and threadpool
-  use: separate worker processes
-  example: "Use Celery or multiprocessing"
-
-never:
-  - "time.sleep() in async functions"
-  - "Blocking I/O in async functions"
-```
-
-### 3. Pydantic Models
-
-```yaml
-validation:
-  use_builtin: regex, enums, email, URL validators
-  custom_validators: for complex logic
-
-base_model:
-  create_custom: true
-  purpose: enforce application-wide standards
-  example: |
-    from pydantic import BaseModel
-    from datetime import datetime
-
-    class AppBaseModel(BaseModel):
-        class Config:
-            from_attributes = True
-            json_encoders = {
-                datetime: lambda v: v.isoformat()
-            }
-
-settings:
-  split: across modules
-  avoid: single global configuration
-  example: |
-    # auth/config.py
-    class AuthSettings(BaseSettings):
-        jwt_secret: str
-        jwt_algorithm: str = "HS256"
-
-    # database/config.py
-    class DatabaseSettings(BaseSettings):
-        url: str
-        pool_size: int = 5
-```
-
-### 4. Dependencies
-
-```yaml
-usage:
-  - Dependency injection
-  - Validation against database
-  - Authentication/authorization
-  - Request scoped caching
-
-patterns:
-  chain: avoid code repetition
-  cache: FastAPI caches within request scope
-  decouple: small, reusable functions
-
-example: |
-  async def get_current_user(
-      token: str = Depends(oauth2_scheme),
-      db: Session = Depends(get_db)
-  ) -> User:
-      user = await db.get_user_by_token(token)
-      if not user:
-          raise HTTPException(status_code=401)
-      return user
-
-  async def get_active_user(
-      user: User = Depends(get_current_user)
-  ) -> User:
-      if not user.is_active:
-          raise HTTPException(status_code=403)
-      return user
-```
-
-### 5. Error Handling
-
-```yaml
-custom_exceptions:
-  scope: module-specific
-  purpose: clarity and consistency
-
-pattern: |
-  # auth/exceptions.py
-  class AuthException(Exception):
-      pass
-
-  class InvalidCredentials(AuthException):
-      pass
-
-  class TokenExpired(AuthException):
-      pass
-
-  # auth/router.py
-  @router.post("/login")
-  async def login(credentials: LoginSchema):
-      try:
-          return await auth_service.login(credentials)
-      except InvalidCredentials:
-          raise HTTPException(
-              status_code=401,
-              detail="Invalid credentials"
-          )
-
-exception_handlers: |
-  @app.exception_handler(AuthException)
-  async def auth_exception_handler(request, exc):
-      return JSONResponse(
-          status_code=401,
-          content={"detail": str(exc)}
-      )
-```
-
-### 6. Database
-
-```yaml
-naming:
-  establish: upfront conventions
-  consistency: across all models
-
-migrations:
-  tool: Alembic
-  naming: explicit naming rules
-
-design:
-  approach: SQL-first
-  then: add Pydantic models
-
-patterns: |
-  # Use async database drivers
-  from sqlalchemy.ext.asyncio import AsyncSession
-
-  async def get_user(db: AsyncSession, user_id: int):
-      result = await db.execute(
-          select(User).where(User.id == user_id)
-      )
-      return result.scalar_one_or_none()
-```
-
-### 7. API Design
-
-```yaml
-routing:
-  prefix: meaningful module prefix
-  tags: for documentation grouping
-
-responses:
-  schema: always define response models
-  status_codes: document all possible codes
-
-example: |
-  router = APIRouter(
-      prefix="/users",
-      tags=["users"]
-  )
-
-  @router.get(
-      "/{user_id}",
-      response_model=UserResponse,
-      responses={
-          404: {"model": ErrorResponse}
-      }
-  )
-  async def get_user(user_id: int):
-      ...
-```
-
-### 8. Testing
-
-```yaml
-setup:
-  async_client: from day one
-  structure: mirror module layout
-
-patterns: |
-  import pytest
-  from httpx import AsyncClient
-
-  @pytest.fixture
-  async def client():
-      async with AsyncClient(app=app, base_url="http://test") as ac:
-          yield ac
-
-  @pytest.mark.asyncio
-  async def test_get_user(client):
-      response = await client.get("/users/1")
-      assert response.status_code == 200
-```
-
-## Application
-
-When writing FastAPI code:
-
-1. **Always** use domain-based project structure
-2. **Always** use `async def` for I/O operations
-3. **Prefer** Pydantic for all validation
-4. **Use** dependencies for reusable logic
-5. **Define** module-specific exceptions
-6. **Document** API with response models
-7. **Test** with async client
-8. **Use** Ruff for code quality

package/templates/.codex/skills/fix-refs/SKILL.md

@@ -1,107 +0,0 @@
----
-name: fix-refs
-description: Fix broken agent references and symlinks
-argument-hint: "[agent-name] [--all] [--dry-run]"
-disable-model-invocation: true
----
-
-# Fix References Skill
-
-Fix broken references, missing symlinks, and other agent dependency issues.
-
-## Options
-
-```
---all, -a        Fix all agents
---dry-run        Show what would be fixed
---verbose, -v    Show detailed actions
-```
-
-## Workflow
-
-```
-1. Run mgr-supplier:audit to identify issues
-
-2. Fix issues:
-   ├── Missing skill references → Add
-   ├── Missing guide references → Add
-   ├── Broken paths → Update
-   └── Invalid references → Remove
-
-3. Validate fixes
-   └── Re-run mgr-supplier:audit
-```
-
-## Fixable Issues
-
-| Issue | Action |
-|-------|--------|
-| Missing skill ref | Add to agent .md file |
-| Missing guide ref | Add to agent .md file |
-| Broken path | Update path in agent .md file |
-| Invalid reference | Remove from agent .md file |
-
-## Output Format
-
-### Dry Run
-```
-[mgr-supplier:fix lang-kotlin-expert --dry-run]
-
-Analyzing: lang-kotlin-expert
-
-Issues found:
-  1. Missing guide reference: kotlin
-
-Proposed fixes:
-  1. Add guide reference to .codex/agents/lang-kotlin-expert.md
-
-No changes made (dry-run mode).
-Run without --dry-run to apply fixes.
-```
-
-### Fix Mode
-```
-[mgr-supplier:fix lang-kotlin-expert]
-
-Fixing: lang-kotlin-expert
-
-[1/2] Adding missing reference...
-  Updating: .codex/agents/lang-kotlin-expert.md
-  ✓ Guide reference added
-
-[2/2] Validating...
-  Running mgr-supplier:audit...
-  ✓ All dependencies valid
-
-Summary:
-  Fixed: 1 issue
-  Status: HEALTHY
-
-Agent lang-kotlin-expert is now healthy.
-```
-
-### Fix All
-```
-[mgr-supplier:fix --all]
-
-Scanning all agents for issues...
-
-Found issues in 2 agents:
-  - lang-kotlin-expert: 1 issue
-  - new-agent: 2 issues
-
-Fixing lang-kotlin-expert...
-  ✓ Added guide reference: kotlin
-
-Fixing new-agent...
-  ✓ Added skill reference: skill-a
-  ✓ Added skill reference: skill-b
-
-Validating all agents...
-  ✓ mgr-supplier:audit --all passed
-
-Summary:
-  Agents fixed: 2
-  Issues resolved: 3
-  All agents healthy.
-```

package/templates/.codex/skills/go-backend-best-practices/SKILL.md

@@ -1,338 +0,0 @@
----
-name: go-backend-best-practices
-description: Go backend patterns from Uber style and standard layout
-user-invocable: false
----
-
-## Purpose
-
-Apply Go backend patterns for building production-ready services.
-
-## Rules
-
-### 1. Project Structure (Standard Layout)
-
-```yaml
-layout: |
-  project/
-  ├── cmd/
-  │   └── server/
-  │       └── main.go
-  ├── internal/
-  │   ├── handler/
-  │   ├── service/
-  │   ├── repository/
-  │   └── model/
-  ├── pkg/
-  │   └── shared/
-  ├── api/
-  │   └── openapi.yaml
-  ├── configs/
-  ├── scripts/
-  ├── Dockerfile
-  ├── Makefile
-  └── go.mod
-
-directories:
-  cmd: Main applications (one per binary)
-  internal: Private application code
-  pkg: Library code safe for external use
-  api: API definitions (OpenAPI, protobuf)
-  configs: Configuration files
-  scripts: Build and CI scripts
-```
-
-### 2. Error Handling (Uber Style)
-
-```yaml
-principles:
-  - Wrap errors with context using %w
-  - Handle errors once (don't log AND return)
-  - Use sentinel errors for specific conditions
-  - Name error variables with Err prefix
-
-patterns: |
-  // Sentinel errors
-  var (
-      ErrNotFound = errors.New("not found")
-      ErrInvalidInput = errors.New("invalid input")
-  )
-
-  // Wrap with context
-  func getUser(id string) (*User, error) {
-      user, err := db.FindUser(id)
-      if err != nil {
-          return nil, fmt.Errorf("getUser %s: %w", id, err)
-      }
-      return user, nil
-  }
-
-  // Check specific errors
-  if errors.Is(err, ErrNotFound) {
-      return http.StatusNotFound
-  }
-```
-
-### 3. Concurrency (Uber Style)
-
-```yaml
-channels:
-  size: "Use 0 (unbuffered) or 1 only"
-  larger: "Requires careful review"
-
-goroutines:
-  never: fire-and-forget
-  always: wait for completion or manage lifecycle
-
-patterns: |
-  // Wait group for goroutines
-  func process(items []Item) error {
-      var wg sync.WaitGroup
-      errCh := make(chan error, 1)
-
-      for _, item := range items {
-          wg.Add(1)
-          go func(item Item) {
-              defer wg.Done()
-              if err := processItem(item); err != nil {
-                  select {
-                  case errCh <- err:
-                  default:
-                  }
-              }
-          }(item)
-      }
-
-      wg.Wait()
-      close(errCh)
-      return <-errCh
-  }
-
-  // Context for cancellation
-  func longRunningTask(ctx context.Context) error {
-      for {
-          select {
-          case <-ctx.Done():
-              return ctx.Err()
-          default:
-              // do work
-          }
-      }
-  }
-```
-
-### 4. HTTP Server
-
-```yaml
-structure:
-  handler: HTTP layer (request/response)
-  service: Business logic
-  repository: Data access
-
-patterns: |
-  // Handler with dependency injection
-  type UserHandler struct {
-      service UserService
-  }
-
-  func NewUserHandler(s UserService) *UserHandler {
-      return &UserHandler{service: s}
-  }
-
-  func (h *UserHandler) GetUser(w http.ResponseWriter, r *http.Request) {
-      id := chi.URLParam(r, "id")
-
-      user, err := h.service.GetUser(r.Context(), id)
-      if err != nil {
-          if errors.Is(err, ErrNotFound) {
-              http.Error(w, "user not found", http.StatusNotFound)
-              return
-          }
-          http.Error(w, "internal error", http.StatusInternalServerError)
-          return
-      }
-
-      json.NewEncoder(w).Encode(user)
-  }
-
-  // Router setup
-  func NewRouter(h *UserHandler) *chi.Mux {
-      r := chi.NewRouter()
-      r.Use(middleware.Logger)
-      r.Use(middleware.Recoverer)
-
-      r.Route("/api/v1", func(r chi.Router) {
-          r.Get("/users/{id}", h.GetUser)
-          r.Post("/users", h.CreateUser)
-      })
-
-      return r
-  }
-```
-
-### 5. Dependency Injection
-
-```yaml
-approach: constructor injection
-avoid: global variables
-
-patterns: |
-  // Service with dependencies
-  type UserService struct {
-      repo   UserRepository
-      cache  Cache
-      logger *slog.Logger
-  }
-
-  func NewUserService(
-      repo UserRepository,
-      cache Cache,
-      logger *slog.Logger,
-  ) *UserService {
-      return &UserService{
-          repo:   repo,
-          cache:  cache,
-          logger: logger,
-      }
-  }
-
-  // Wire up in main
-  func main() {
-      logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
-      db := database.New(cfg.DatabaseURL)
-      cache := redis.New(cfg.RedisURL)
-
-      repo := repository.NewUserRepository(db)
-      service := service.NewUserService(repo, cache, logger)
-      handler := handler.NewUserHandler(service)
-
-      router := handler.NewRouter(handler)
-      http.ListenAndServe(":8080", router)
-  }
-```
-
-### 6. Configuration
-
-```yaml
-approach:
-  - Use environment variables
-  - Validate at startup
-  - Group related settings
-
-patterns: |
-  type Config struct {
-      Server   ServerConfig
-      Database DatabaseConfig
-      Redis    RedisConfig
-  }
-
-  type ServerConfig struct {
-      Host         string        `env:"SERVER_HOST" envDefault:"0.0.0.0"`
-      Port         int           `env:"SERVER_PORT" envDefault:"8080"`
-      ReadTimeout  time.Duration `env:"SERVER_READ_TIMEOUT" envDefault:"5s"`
-      WriteTimeout time.Duration `env:"SERVER_WRITE_TIMEOUT" envDefault:"10s"`
-  }
-
-  func LoadConfig() (*Config, error) {
-      var cfg Config
-      if err := env.Parse(&cfg); err != nil {
-          return nil, fmt.Errorf("parse config: %w", err)
-      }
-      return &cfg, nil
-  }
-```
-
-### 7. Testing
-
-```yaml
-patterns:
-  table_driven: for comprehensive coverage
-  interfaces: for mocking
-  parallel: for speed
-
-example: |
-  func TestUserService_GetUser(t *testing.T) {
-      tests := []struct {
-          name    string
-          userID  string
-          mock    func(*MockRepository)
-          want    *User
-          wantErr error
-      }{
-          {
-              name:   "success",
-              userID: "123",
-              mock: func(m *MockRepository) {
-                  m.EXPECT().FindByID("123").Return(&User{ID: "123"}, nil)
-              },
-              want: &User{ID: "123"},
-          },
-          {
-              name:   "not found",
-              userID: "999",
-              mock: func(m *MockRepository) {
-                  m.EXPECT().FindByID("999").Return(nil, ErrNotFound)
-              },
-              wantErr: ErrNotFound,
-          },
-      }
-
-      for _, tt := range tests {
-          t.Run(tt.name, func(t *testing.T) {
-              t.Parallel()
-              ctrl := gomock.NewController(t)
-              repo := NewMockRepository(ctrl)
-              tt.mock(repo)
-
-              svc := NewUserService(repo, nil, slog.Default())
-              got, err := svc.GetUser(context.Background(), tt.userID)
-
-              if !errors.Is(err, tt.wantErr) {
-                  t.Errorf("got error %v, want %v", err, tt.wantErr)
-              }
-              if diff := cmp.Diff(tt.want, got); diff != "" {
-                  t.Errorf("mismatch (-want +got):\n%s", diff)
-              }
-          })
-      }
-  }
-```
-
-### 8. Performance (Uber Style)
-
-```yaml
-guidelines:
-  - Use strconv over fmt for conversions
-  - Pre-allocate slices with known capacity
-  - Avoid repeated string-to-byte conversions
-  - Copy slices/maps at boundaries
-
-patterns: |
-  // Pre-allocate
-  items := make([]Item, 0, len(input))
-
-  // strconv for conversions
-  s := strconv.Itoa(n) // not fmt.Sprintf("%d", n)
-
-  // Copy at boundaries
-  func (s *Store) GetItems() []Item {
-      s.mu.RLock()
-      defer s.mu.RUnlock()
-      items := make([]Item, len(s.items))
-      copy(items, s.items)
-      return items
-  }
-```
-
-## Application
-
-When writing Go backend code:
-
-1. **Always** use standard project layout
-2. **Always** wrap errors with context
-3. **Never** fire-and-forget goroutines
-4. **Use** constructor injection
-5. **Use** table-driven tests
-6. **Handle** errors once
-7. **Copy** data at boundaries
-8. **Validate** config at startup