# OurDigital Skill Patterns

Common patterns and best practices for OurDigital Claude Skills.

## Directory Structure Pattern

```
XX-ourdigital-{name}/
├── code/
│   └── SKILL.md          # Claude Code version
├── desktop/
│   └── SKILL.md          # Claude Desktop version
├── shared/
│   ├── references/       # Documentation
│   ├── templates/        # Reusable templates
│   └── scripts/          # Utility scripts
├── docs/
│   ├── CHANGELOG.md      # Version history
│   └── logs/             # Update logs
└── README.md             # Overview
```

## YAML Frontmatter Pattern

```yaml
---
name: ourdigital-{skill-name}
description: |
  [One-line purpose statement]
  Activated with "ourdigital" keyword.

  Triggers:
  - "ourdigital {keyword1}", "ourdigital {keyword2}"
  - "ourdigital-{skill-name} {action}"

  Features:
  - Feature 1 description
  - Feature 2 description
version: "1.0"
author: OurDigital
environment: Desktop | Code | Both
dependencies:
  python: ">=3.11"
  packages: ["package1", "package2"]
---
```

## Workflow Patterns

### Linear Workflow

```
Phase 1 → Phase 2 → Phase 3 → Output
```

Example: ourdigital-blog
```
Topic Input → Research → Draft → SEO Meta → Export
```

### Interactive Q&A Workflow

```
Ask Q1 → Get A1 → Ask Q2 → Get A2 → Process → Output
```

Example: ourdigital-skill-creator
```
Purpose? → Triggers? → Tools? → Output? → Generate
```

### Multi-Output Workflow

```
Input → Process → Output A
              └→ Output B
              └→ Output C
```

Example: ourdigital-designer
```
Brief → Analyze → DALL-E prompt
               └→ Midjourney prompt
               └→ Figma spec
```

## Trigger Patterns

### Korean + English Pairs

```yaml
Triggers:
- "ourdigital 블로그", "ourdigital blog"
- "ourdigital 작성", "ourdigital write"
```

### Action-Based

```yaml
Triggers:
- "ourdigital create {type}"
- "ourdigital generate {type}"
- "ourdigital check {type}"
```

### Skill Name Direct

```yaml
Triggers:
- "ourdigital-blog 초안"
- "ourdigital-designer 프롬프트"
```

## Output Patterns

### File Export

```markdown
## Output

Export to:
- iCloud/Ulysses folder: `.md` files
- Google Drive: `.docx`, `.pptx`
- Local: `./output/`
```

### Notion Integration

```markdown
## Notion Save

Database: Working with AI
Properties:
- Name: [Output title]
- Status: Done
- AI used: Claude Code
```

### Artifact Generation

```markdown
## Artifact

Generate HTML artifact with:
- Structured sections
- Styled formatting
- Export options
```

## Reference Patterns

### Style Guide Reference

```markdown
See `shared/references/style-guide.md` for:
- Tone and voice
- Terminology
- Formatting rules
```

### API Config Reference

```markdown
See `shared/references/api-config.md` for:
- Endpoint URLs
- Authentication
- Rate limits
```

### Template Reference

```markdown
Use `shared/templates/{template}.md` as base structure.
```

## Version Numbering

```
Major.Minor.Patch

1.0.0 - Initial release
1.1.0 - New feature added
1.1.1 - Bug fix
2.0.0 - Breaking change
```

## Changelog Pattern

```markdown
## [1.1.0] - 2026-01-31

### Added
- New feature X

### Changed
- Updated behavior Y

### Fixed
- Bug in Z

### Notion Ref
- https://notion.so/page-id
```