feat(skills): add ontology-design (Palantir best practices / anti-patterns)

[EnzoTironi]

Summary

Adds $ontology-design, a Cursor-pattern skill (progressive disclosure + disable-model-invocation: true) for designing and reviewing ontologies from Palantir Foundry's official trilogy:

• Best practices
• Structural guidance
• Anti-patterns

Includes offline dumps of neighboring linked pages under references/sources/.

Also

• Catalog + README install note
• Route from $zoen-product-engineering for ontology shape / anti-pattern review
• Validator allows Cursor disable-model-invocation frontmatter
• Codex agents/openai.yaml kept with allow_implicit_invocation: false (user-invoked)

Install

npx skills add EnzoTironi/skills --skill ontology-design --global --yes

Summary by CodeRabbit

• New Features

  • Added an ontology-design skill for modeling, reviewing, and improving ontology structures.
  • Added guidance for interfaces, links, properties, actions, security, semantic search, document processing, and lifecycle management.
  • Added anti-pattern detection and recommendations for practical ontology design decisions.
  • Added a review workflow with standardized outputs and product-adaptation guidance.

• Documentation

  • Added comprehensive best-practice references, source materials, examples, and supporting metadata.
  • Documented semantic-search workflows using both custom and platform-provided models.
  • Updated the skill catalog and validation guidance to support the new capability.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: a1f23ba5-a2e9-4b48-a85b-0290bdf81dfd

📥 Commits

Reviewing files that changed from the base of the PR and between 7705222 and 0aaec9a.

📒 Files selected for processing (23)

• .agents/skills/ontology-design/SKILL.md
• .agents/skills/ontology-design/agents/openai.yaml
• .agents/skills/ontology-design/references/anti-patterns.md
• .agents/skills/ontology-design/references/best-practices.md
• .agents/skills/ontology-design/references/linked-pages.md
• .agents/skills/ontology-design/references/sources/README.md
• .agents/skills/ontology-design/references/sources/configuring-rv-access-controls.md
• .agents/skills/ontology-design/references/sources/derived-properties.md
• .agents/skills/ontology-design/references/sources/document-processing.md
• .agents/skills/ontology-design/references/sources/interfaces-interface-metadata.md
• .agents/skills/ontology-design/references/sources/interfaces-interface-overview.md
• .agents/skills/ontology-design/references/sources/law-of-the-instrument-wikipedia.md
• .agents/skills/ontology-design/references/sources/metadata-statuses.md
• .agents/skills/ontology-design/references/sources/ontology-anti-patterns.md
• .agents/skills/ontology-design/references/sources/ontology-best-practices.md
• .agents/skills/ontology-design/references/sources/ontology-structural-guidance.md
• .agents/skills/ontology-design/references/sources/overview-semantic-search.md
• .agents/skills/ontology-design/references/sources/using-custom-models-semantic-search.md
• .agents/skills/ontology-design/references/sources/using-palantir-provided-models-semantic-search.md
• .agents/skills/ontology-design/references/structural-guidance.md
• .agents/skills/zoen-product-engineering/SKILL.md
• README.md
• scripts/validate_skills.py

---

📝 Walkthrough

Walkthrough

Added the ontology-design skill with Palantir Foundry guidance, anti-pattern and structural references, semantic-search workflows, agent metadata, repository registration, and validator support.

Changes

Ontology Design Skill

Layer / File(s)	Summary
Skill definition and repository integration .agents/skills/ontology-design/SKILL.md, .agents/skills/ontology-design/agents/openai.yaml, .agents/skills/zoen-product-engineering/SKILL.md, README.md, scripts/validate_skills.py	Added the skill definition, agent configuration, flow-selection entry, catalog entries, repository layout metadata, and supported frontmatter key.
Ontology design principles and structural guidance .agents/skills/ontology-design/references/anti-patterns.md, .agents/skills/ontology-design/references/best-practices.md, .agents/skills/ontology-design/references/structural-guidance.md, .agents/skills/ontology-design/references/linked-pages.md, .agents/skills/ontology-design/references/sources/ontology-*.md, .agents/skills/ontology-design/references/sources/law-of-the-instrument-wikipedia.md, .agents/skills/ontology-design/references/sources/README.md	Added guidance for domain-driven modeling, canonical types, interfaces, links, naming, security, tool selection, tradeoffs, and eight ontology anti-patterns.
Ontology platform references .agents/skills/ontology-design/references/sources/configuring-rv-access-controls.md, .agents/skills/ontology-design/references/sources/derived-properties.md, .agents/skills/ontology-design/references/sources/interfaces-*.md, .agents/skills/ontology-design/references/sources/metadata-statuses.md, .agents/skills/ontology-design/references/sources/document-processing.md	Added references for restricted views, derived properties, interface metadata and behavior, ontology statuses, and document chunking workflows.
Semantic-search workflow references .agents/skills/ontology-design/references/sources/overview-semantic-search.md, .agents/skills/ontology-design/references/sources/using-*-semantic-search.md	Added semantic-search concepts and workflows using Palantir-provided or custom embedding models, vector properties, KNN queries, TypeScript functions, Workshop, AIP Chatbot, and AIP Logic.

Estimated code review effort: 3 (Moderate) | ~25 minutes

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch cursor/ontology-design-skill-4b66

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}