oh-my-customcodex 0.1.0

package/templates/.claude/skills/update-docs/SKILL.md

@@ -0,0 +1,142 @@
+---
+name: omcodex:update-docs
+description: Sync documentation with project structure
+scope: harness
+argument-hint: "[--check] [--target <path>]"
+disable-model-invocation: true
+user-invocable: true
+---
+
+# Update Documentation Skill
+
+Ensures all documentation (AGENT.md, SKILL.md, index.yaml, AGENTS.md) accurately reflects the current project state and that agents work together organically.
+
+## Options
+
+```
+--check, -c      Check only, don't modify
+--verbose, -v    Show detailed changes
+--target, -t     Specific target to update
+```
+
+## Workflow
+
+```
+1. Scan project structure
+   ├── .codex/agents/
+   ├── .codex/skills/
+   ├── templates/guides/
+   └── commands/
+
+2. Validate consistency
+   ├── Check agent files exist
+   ├── Check skill references exist
+   ├── Check guide references exist
+   └── Check command definitions match files
+
+3. Update documentation
+   ├── Verify all .codex/agents/*.md files
+   ├── Verify all .codex/skills/*/SKILL.md files
+   ├── Update AGENTS.md summary
+   └── Update inter-agent references
+
+4. Ensure organic integration
+   ├── Verify agent → skill mappings
+   ├── Verify agent → guide mappings
+   ├── Verify command → agent mappings
+   └── Check for orphaned resources
+```
+
+## What Gets Updated
+
+### Agent Files
+- All .codex/agents/*.md files exist and are valid
+- No orphaned or missing agents
+- Metadata is consistent
+
+### Skill Files
+- All .codex/skills/*/SKILL.md files exist
+- Skill categories reflect actual structure
+- References are valid
+
+### AGENTS.md
+- Project structure diagram
+- Agent/skill/guide counts
+- Command list
+- Summary tables
+
+### Individual Agent/Skill Files
+- Skill references in agent files
+- Guide references in agent files
+- Cross-agent references
+
+## Organic Integration Checks
+
+```yaml
+agent_skill_mapping:
+  - Each agent declares valid skills
+  - Skills are in correct category
+  - No duplicate skill declarations
+
+agent_guide_mapping:
+  - Each agent declares valid guides
+  - Guides exist in templates/guides/
+  - Paths are relative and correct
+
+command_agent_mapping:
+  - Commands reference valid agents
+  - Agent capabilities match commands
+  - Workflow is documented
+```
+
+## Output Format
+
+### Check Mode
+```
+[/update-docs --check]
+
+Scanning project structure...
+
+Agents:
+  ✓ 15 agents found in .codex/agents/
+  ✗ Missing: lang-java21-expert.md (referenced but not found)
+
+Skills:
+  ✓ 13 skills found in .codex/skills/
+  ✓ All SKILL.md files valid
+
+Guides:
+  ✓ 12 guides declared
+  ✗ Orphan: templates/guides/old-guide/ (exists but not referenced)
+
+AGENTS.md:
+  ✗ Agent count outdated (shows 14, actual 15)
+
+Issues Found: 3
+Run "/update-docs" to fix.
+```
+
+### Update Mode
+```
+[/update-docs]
+
+Syncing documentation with project structure...
+
+[1/3] Verifying agents
+  - Removed reference: lang-java21-expert (not found)
+  ✓ 15 → 14 agents
+
+[2/3] Verifying skills
+  ✓ No changes needed
+
+[3/3] Updating AGENTS.md
+  - Updated agent count: 14 → 15
+  - Updated summary table
+  ✓ Synced
+
+Summary:
+  Modified: 1 file
+  Removed: 1 reference
+
+All documentation synced successfully.
+```

package/templates/.claude/skills/update-external/SKILL.md

@@ -0,0 +1,169 @@
+---
+name: omcodex:update-external
+description: Update agents from external sources (GitHub, docs, etc.)
+scope: harness
+argument-hint: "[agent-name] [--check] [--force]"
+disable-model-invocation: true
+user-invocable: true
+---
+
+# Update External Sources Skill
+
+Updates agents, skills, and guides that have external sources (GitHub, official docs, etc.) to their latest versions.
+
+## Options
+
+```
+--check, -c      Check for updates without applying
+--force, -f      Force update even if current
+--verbose, -v    Show detailed changes
+```
+
+## External Sources
+
+### Agents
+```yaml
+fe-vercel-agent:
+  source: https://github.com/vercel-labs/agent-skills
+  type: github
+```
+
+### Skills (from external agents)
+```yaml
+react-best-practices:
+  source: https://github.com/vercel-labs/agent-skills
+  type: github
+
+web-design-guidelines:
+  source: https://github.com/vercel-labs/agent-skills
+  type: github
+```
+
+### Skills (from skills.sh marketplace)
+```yaml
+<skill-name>:
+  source: <owner/repo>
+  type: skills-sh
+```
+
+Skills installed via `skills-sh-search` are tracked with `source-type: skills-sh` in their frontmatter. Update checks use `npx skills check`.
+
+### Guides (reference documentation)
+```yaml
+golang:
+  source: https://go.dev/doc/effective_go
+  type: documentation
+
+python:
+  source: https://peps.python.org/pep-0008/
+  type: documentation
+```
+
+## Workflow
+
+```
+1. Identify external resources
+   ├── Scan index.yaml files
+   ├── Find source.type = "external"
+   └── Collect URLs and versions
+
+2. Check for updates
+   ├── GitHub: Check releases/commits
+   ├── skills-sh: Run "npx skills check"
+   ├── Documentation: Check last-modified
+   └── Compare with current version
+
+3. Fetch updates
+   ├── Download new content
+   ├── Parse and extract relevant parts
+   └── Validate content
+
+4. Apply updates
+   ├── Update content files
+   ├── Update version in index.yaml
+   ├── Update last_updated timestamp
+   └── Run mgr-supplier:audit to validate
+```
+
+## Version Tracking
+
+Updates are tracked in each resource's index.yaml:
+
+```yaml
+source:
+  type: external
+  origin: github
+  url: https://github.com/vercel-labs/agent-skills
+  version: "1.2.0"
+  last_updated: "2026-01-22"
+  update_history:
+    - version: "1.0.0"
+      date: "2026-01-20"
+    - version: "1.2.0"
+      date: "2026-01-22"
+
+# skills.sh source
+source:
+  type: external
+  origin: skills-sh
+  registry: https://skills.sh
+  installed_via: "npx skills add <owner/repo>"
+  last_checked: "2026-02-20"
+```
+
+## Output Format
+
+### Check Mode
+```
+[mgr-updater:external --check]
+
+Checking for external updates...
+
+Agents:
+  fe-vercel-agent
+    Current: v1.0.0
+    Latest:  v1.2.0
+    Status:  UPDATE AVAILABLE
+
+Skills:
+  react-best-practices
+    Source: github.com/vercel-labs/agent-skills
+    Status: UPDATE AVAILABLE (linked to agent)
+
+Guides:
+  golang
+    Source: go.dev/doc/effective_go
+    Last fetched: 2026-01-22
+    Status: UP TO DATE
+
+Summary:
+  Updates available: 1 agent, 1 skill
+  Up to date: 11 guides
+
+Run "mgr-updater:external" to apply updates.
+```
+
+### Update Mode
+```
+[mgr-updater:external]
+
+Updating external resources...
+
+[1/2] Updating fe-vercel-agent
+  Fetching from github.com/vercel-labs/agent-skills...
+  ✓ Downloaded v1.2.0
+  ✓ Updated AGENT.md
+  ✓ Updated index.yaml (version: 1.0.0 → 1.2.0)
+  ✓ Updated related skills
+
+[2/2] Validating updates
+  Running mgr-supplier:audit...
+  ✓ All dependencies valid
+
+Summary:
+  Updated: 1 agent
+  Synced: 3 skills
+  Validated: ✓
+
+All external resources updated successfully.
+```

package/templates/.claude/skills/vercel-deploy/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: vercel-deploy
+description: Deploy applications to Vercel with auto-detection and preview URLs
+scope: core
+user-invocable: true
+---
+
+## When to Use
+
+- Deploy application to Vercel
+- Create preview deployments
+- Generate shareable URLs
+
+## Features
+
+### Framework Detection
+```
+Auto-detects 40+ frameworks from package.json:
+- Next.js
+- React
+- Vue
+- Nuxt
+- Svelte
+- Astro
+- and more...
+```
+
+### Auto Exclusions
+```
+Automatically excludes:
+- node_modules/
+- .git/
+- .env files
+```
+
+### Output
+```
+On successful deployment:
+1. Preview URL (view deployment)
+2. Claim URL (transfer ownership)
+```
+
+## Execution Flow
+
+```
+1. Detect project framework
+2. Prepare deployment bundle
+3. Upload to Vercel
+4. Return URLs
+```
+
+## Output Format
+
+```
+[Deploy Success]
+Preview: https://project-xxx.vercel.app
+Claim: https://vercel.com/claim/xxx
+```
+
+## Scripts
+
+See `scripts/deploy.sh` for deployment automation.
+
+## Requirements
+
+- Valid project structure
+- package.json present
+- Vercel CLI or API token (for authenticated deploys)
+
+## Limitations
+
+- Claimable deploys are anonymous
+- Preview URLs are temporary
+- Full features require Vercel account
+```

package/templates/.claude/skills/web-design-guidelines/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: web-design-guidelines
+description: UI code review with 100+ rules for accessibility, performance, and UX
+scope: core
+user-invocable: false
+---
+
+## When to Use
+
+- UI code review
+- Accessibility audit
+- Design consistency check
+- UX best practices verification
+
+## Command Triggers
+
+- "Review UI"
+- "Check accessibility"
+- "Design audit"
+- "Verify best practices"
+
+## Categories
+
+### ARIA Labels
+```
+- All interactive elements have labels
+- Proper role attributes
+- aria-live for dynamic content
+- Descriptive aria-describedby
+```
+
+### Focus States
+```
+- Visible focus indicators
+- Logical focus order
+- Focus trapping in modals
+- Skip links for navigation
+```
+
+### Form Validation
+```
+- Inline error messages
+- Accessible error announcements
+- Clear input requirements
+- Proper label associations
+```
+
+### Animations
+```
+- Respect prefers-reduced-motion
+- Meaningful animations only
+- Performance-optimized transforms
+- No animation on load
+```
+
+### Typography
+```
+- Readable font sizes (16px min)
+- Proper line height (1.5+)
+- Sufficient color contrast
+- Responsive text scaling
+```
+
+### Images
+```
+- Alt text for all images
+- Decorative images marked
+- Responsive images
+- Lazy loading implemented
+```
+
+### Performance
+```
+- Minimize layout shifts
+- Optimize largest contentful paint
+- Reduce time to interactive
+- Efficient CSS selectors
+```
+
+### Navigation
+```
+- Keyboard accessible
+- Clear current state
+- Consistent patterns
+- Breadcrumbs where needed
+```
+
+### Dark Mode
+```
+- System preference detection
+- Smooth transitions
+- Consistent color tokens
+- Image adjustments
+```
+
+### Touch Interaction
+```
+- Minimum 44px touch targets
+- Appropriate spacing
+- Gesture alternatives
+- Haptic feedback consideration
+```
+
+### i18n
+```
+- RTL support
+- Text expansion room
+- Locale-aware formatting
+- Translation-ready strings
+```
+
+## Execution Flow
+
+```
+1. Scan UI components
+2. Check against category rules
+3. Report violations
+4. Suggest fixes
+```