# Obsidian Development Skills

This repository contains centralized AI agent skills for Obsidian plugin and theme development. It provides a single source of truth for development guidance, patterns, and best practices.

## Repository Structure

``` obsidian-dev-skills/ ├── obsidian-dev/ # Plugin development skills ├── obsidian-theme-dev/ # Theme development skills ├── obsidian-ops/ # Operations & workflows └── obsidian-ref/ # Technical references ```

## Installation & Usage

This package can be used as a development dependency in your Obsidian project.

### 1. Install to your project ```bash # Using pnpm (Recommended) pnpm add -D obsidian-dev-skills

# Using npm npm install --save-dev obsidian-dev-skills

# Using yarn yarn add -D obsidian-dev-skills ```

### 2. Initialize localized skills Run the initialization script to seed the `.agent/skills/` folder and sync `AGENTS.md`. This also creates a project-specific skill template if one is missing.

```bash # Using pnpm (Standard entry point) pnpm obsidian-dev-skills

# Using npx (Universal entry point) npx obsidian-dev-skills

# Manual execution node node_modules/obsidian-dev-skills/scripts/init.mjs ```

## Skills Overview

### obsidian-dev - TypeScript/JavaScript development patterns - Obsidian API usage - Plugin lifecycle management - Command and settings implementation - `obsidianmd` ESLint rule patterns (`createDiv`/`createSpan`, `activeWindow`, `activeDocument`, sentence case)

### obsidian-theme-dev - CSS/SCSS development patterns - Obsidian CSS variables - Responsive design - Dark/light mode support

### obsidian-ops - Build and release workflows - Version management - Sync procedures - Testing and quality assurance - Obsidian community **scorecard compliance** mapping (vulnerable transitive dep handling via `pnpm.overrides`, duplicate CSS selector detection, ESLint rule violations) - Release workflow with **build provenance attestation** (`actions/attest-build-provena