feat(skills): add skill entity seed schema and boot-time registration#315
feat(skills): add skill entity seed schema and boot-time registration#315castor-agent wants to merge 10 commits into
Conversation
…ntent (#267) Add Intent-triggered task creation rule to [TASKS & COMMITMENTS] section of MCP instructions. When user messages contain trigger phrases ("I need to", "remind me", "follow up", "I should", "don't let me forget", "make sure I", "I have to", "I want to", "I must", "don't forget", "remember to"), agents MUST create a task entity with entity_type: "task" and status: "pending" in the user-phase store (Step 2) before composing the reply. Explicit FORBIDDEN clauses prevent deferring task creation or skipping it when trigger phrases are present. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
… creation (#253) Add [RELATIONSHIP CREATION] section to the MCP fenced instruction block with five rules: - Pre-store candidate discovery: check for logically related entities before completing a store; FORBIDDEN to skip this consideration - Relationship-in-same-store: prefer the store relationships array over separate create_relationship calls; use create_relationships only as follow-up when target id was unknown at store time - Canonical relationship examples: 8 typed REFERS_TO patterns (person→org, task→conversation, activity→source conversation, issue→plan/spec, note→subject, event→place, task→person, entity→source artifact) - retrieve_related_entities for traversal guidance - Relationship direction convention for REFERS_TO and PART_OF Add pointer-only entry in cli_agent_instructions.md per canonical-first sync rules (no duplicating full instruction body). Update Design rationale section inventory to include [RELATIONSHIP CREATION]. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
When the diff-size gate evaluates to substantial=false, a new step posts a PR comment stating the file/line count and the thresholds that would trigger a review, plus the @claude review escape hatch. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Update inspector to entity history, timeline layers, and design showcase. Refine lexical search so multi-word titles containing registered type names still match (e.g. plan titles ending in "Strategy"). Add shadcn audit/rules and FU-2026-05-003 plan. Docs hierarchy Playwright spec lands separately once GET /docs?format=json is wired.
Adds `src/services/skills/seed_schema.ts` — an idempotent boot-time schema seeder for the `skill` entity type, following the same pattern as plans and issues. Wires `seedSkillSchema()` into `actions.ts` so the global skill schema (fields: name, description, triggers, content, slug, user_invocable, enabled, version, supported_harnesses, harness_config, synced_at) is guaranteed to exist on every server start, surviving fresh DB installs without requiring manual MCP calls. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Adds `docs/developer/skills_guide.md` covering skill entity storage, MCP/CLI retrieval, mirror-to-disk layout, slash-command palette activation via `user_invocable`, and the full field reference. Also adds the Feature guides section to `getting_started.md` (in line with PR #314) with skills listed alongside plans, issues, mirror, and subscriptions. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Main repo root has no .env file; env lives in ~/.config/neotoma/.env. Add it as the last fallback candidate so worktrees get an env baseline. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…bump Restore queryEntitiesByExactEntityId for full ent_* search strings (header search and API). Add unit tests for entity-type keyword boost and integration tests for id resolution. Point inspector submodule at design catalog, route loading UX, snapshot_display wiring, and abort-aware search hooks. Fix inspector mount integration fixtures for /inspector base path validation.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
/create_pr skill auditAutomated audit against the Verdict: does not fully meet standards. Gaps below; recommended changes follow each item. Findings
Recommended changesUpdate the PR description to match the skill template exactly: ## Problems
- <Concrete pain point or gap.>
## Solutions
- <Concrete change made.>
## UX improvements
- <User-visible behavior change, or `No user-visible change.`>
## Documentation
- <docs/... path(s) added or updated; parameters/outputs/examples/error modes covered.>
- <`docs/site/site_doc_manifest.yaml` entry added/updated; docs service tests pass.>
- <Or: `No functional change; no user-facing docs required.`>
## Test plan
- [ ] `npm run type-check`
- [ ] `npm test`
- [ ] `npm test -- src/services/docs` (if docs changed)
- [ ] Manual verification: <steps>
## Breaking changes
No breaking changes.
## Related
- Plan: <Neotoma plan entity_id or docs/ path>
- Issue(s): <#N>
🤖 Generated with [Claude Code](https://claude.com/claude-code)Functional surfaces detected from the diff: MCP. Per the skill, the Posted by |
Branch pinned inspector at 9ea252460 which is not publicly reachable in neotoma-inspector, causing CI to fail with 'not our ref' on submodule init. Reset to 206e14e (the commit main currently pins). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Summary
src/services/skills/seed_schema.ts— idempotent boot-time schema seeder for theskillentity type, following the same pattern asplans/seed_schema.tsandissues/seed_schema.tsseedSkillSchema()intoactions.tsalongside issue and plan seeds so the global skill schema is guaranteed on every server startname,description,triggers,content,slug,user_invocable,enabled,version,supported_harnesses,harness_config,synced_atcanonical_name_fields: ["name"]— one row per skill name per instanceuser_specific: false(global schema),migrate_existing: truefor incremental field backfillsdocs/developer/skills_guide.md— user-facing guide for skills (storage, retrieval, mirror, slash-palette), in line with the feature guides added in docs: add user-facing feature guides (plans, issues, mirror, subs) #314docs/developer/getting_started.mdwith skills alongside plans, issues, mirror, and subscriptionsRelationship to #314
PR #314 adds user-facing feature guides for plans, issues, mirror, and subscriptions. This PR adds the equivalent guide for skills and includes the same Feature guides section in
getting_started.md. These two PRs will have a minor conflict ongetting_started.md(both add the same section header) — whichever merges second should keep both entries.Test plan
skillschema without errorSKILL_FIELDSon a running instance triggers incremental update and migrates existing rowsdocs/developer/skills_guide.mdrenders on/docsroute🤖 Generated with Claude Code