solid-router-data-navigation

Files (2)

• SKILL.md
• README.md · references/

SKILL.md (first lines)

# solid-router-data-navigation

## Trigger

Use for Solid Router requests involving routes, params/search params, queries/actions, preloading, and navigation semantics.

## Required Inputs

- Route structure and navigation behavior.
- Data loading/mutation expectations.
- Error and revalidation strategy.

## Workflow

1. Resolve route structure and nesting strategy.
2. Choose data APIs (`query`, `action`, `createAsync`, `revalidate`) based on mutation/read flow.
3. Declare loading, pending submission, success, and error states.
4. Provide integration handoff to macro skill and testing checks.

## Failure Modes

- Route param/search ambiguity: require explicit URL contract.
- Data mutation without revalidation policy: add policy before completion.
- Missing error/loading handling: output invalid until state matrix exists.

## Output Contract

Return `DomainGuidanceOutput` with router API decisions, handoff steps, and citations referencing normalized `doc_id` values.

## Validation

- `node tools/scripts/validate-skills.mjs --skill solid-router-data-navigation`
- `node tools/scripts/validate-solid-corpus.mjs`

## Key Corpus References

Use these `doc_id` values with the `read_corpus_doc` MCP tool:

- `solid-router.solid-router.reference.data-apis.query` — data loading with caching
- `solid-router.solid-router.reference.data-apis.action` — server mutations
- `solid-router.solid-router.reference.data-apis.revalidate` — cache invalidation
- `solid-router.solid-router.reference.primitives.use-navigate` — programmatic navigation
- `solid-router.solid-router.reference.primitives.use-params` — route parameter access

## References

- `../../references/solidjs-normalized/docs/solid-router/reference/components/router.md`
- `../../references/solidjs-normalized/docs/solid-router/reference/primitives/use-navigate.md`
- `../../references/solidjs-normalized/docs/solid-router/reference/data-apis/query.md`
- `../../references/solidjs-normalized/docs/solid-router/reference/data-apis/action.md`
- `../../references/solidjs-normalized/manifest.jsonl`

From lvcoi/solidJSkills, MIT.

More from lvcoi/solidJSkills