Portability: Hard-coded `.claude/` paths and unknown `opencode.json` config keys (89 warnings)

Summary

Two separate portability issues flagged by agnix lint — 89 warnings total:

1. Hard-coded tool-specific paths (.claude/ and ~/.claude/) in reference docs
2. Unknown keys in the opencode.json template that fail against the current OpenCode config schema

---

Issue 1 — Hard-coded Claude Code paths (portability)

Reference documents inside .claude/skills/*/references/ repeatedly point to .claude/ and ~/.claude/ as install locations. Users installing via the OpenCode platform or other AI coding assistants use different paths (e.g. .opencode/, ~/.config/opencode/), so these paths silently break copy-paste instructions.

Example warnings (representative subset):

.claude/skills/brand/references/approval-checklist.md:160  warning: Hard-coded Claude Code path '.claude/'
.claude/skills/design/references/cip-design.md:19          warning: Hard-coded Claude Code path '~/.claude/'
.claude/skills/design/references/design-routing.md:167     warning: Hard-coded Claude Code path '.claude/'
.claude/skills/design/references/icon-design.md:16         warning: Hard-coded Claude Code path '~/.claude/'

Suggested fix: Replace hard-coded paths with platform-agnostic language:

<!-- Before -->
Copy SKILL.md to `~/.claude/skills/brand/SKILL.md`

<!-- After -->
Copy SKILL.md to your AI assistant's skill directory
(Claude Code: `~/.claude/skills/brand/`, OpenCode: `~/.config/opencode/skills/brand/`)

Or use a variable/placeholder that the installer script substitutes at install time.

---

Issue 2 — Unknown config keys in opencode.json template

src/ui-ux-pro-max/templates/platforms/opencode.json contains keys that are not part of the current OpenCode configuration schema:

opencode.json:3   warning: Unknown top-level config key 'displayName'
opencode.json:4   warning: Unknown top-level config key 'installType'
opencode.json:5   warning: Unknown top-level config key 'folderStructure'
opencode.json:10  warning: Unknown top-level config key 'scriptPath'
opencode.json:11  warning: Unknown top-level config key 'frontmatter'
opencode.json:13  warning: Unknown top-level config key 'description'
opencode.json:15  warning: Unknown top-level config key 'sections'
opencode.json:18  warning: Unknown top-level config key 'title'
opencode.json:20  warning: Unknown top-level config key 'skillOrWorkflow'

This template will either be rejected or silently ignored by OpenCode when users follow the installation guide. Either the template needs to be updated to match the current OpenCode schema, or these keys should be marked clearly as comments/docs rather than live config.

---

Reproduction

npm install -g agnix
git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
agnix ./ui-ux-pro-max-skill/
# → Found 89 warnings

Validated with agnix v0.17.0 on April 18, 2026.