Skill consolidation - #80
Draft
crhntr wants to merge 2 commits into
Draft
Conversation
There was a problem hiding this comment.
Pull request overview
This PR consolidates several Muxt “explore” skills into a single muxt_explore skill and restructures multiple existing skills by moving long-form examples into references/examples.md files, while also updating a Go dependency.
Changes:
- Consolidate the former
explore-from-*/explore-repo-overviewskills into a singledocs/skills/muxt_explore/SKILL.md(and remove the old skill docs). - Refactor multiple skill docs (TDD, forms, HTMX, sqlc, refactoring, debug-generation-errors, etc.) to be shorter, with detailed examples moved into new
references/files. - Bump
github.com/typelate/domfromv0.7.5tov0.7.6.
Reviewed changes
Copilot reviewed 26 out of 28 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| README.md | Updates the top-level skills list to point to the consolidated explore skill. |
| go.mod | Bumps github.com/typelate/dom to v0.7.6. |
| go.sum | Adds checksums for github.com/typelate/dom v0.7.6. |
| docs/README.md | Updates docs index to reference the consolidated explore skill. |
| docs/reference/commands/explore-module.md | Updates cross-links to point to the consolidated explore skill. |
| docs/reference/commands/generate-fake-server.md | Updates cross-links to point to the consolidated explore skill. |
| docs/skills/muxt_debug-generation-errors/SKILL.md | Shortens/restructures the skill and adds quick lookup + reference to the new error catalog. |
| docs/skills/muxt_debug-generation-errors/references/error-catalog.md | Adds a centralized catalog of error categories, causes, fixes, and test-case pointers. |
| docs/skills/muxt_explore/SKILL.md | Introduces the consolidated “explore” skill (route/method/error/repo overview entry points). |
| docs/skills/muxt_explore/scripts/scan-navigation.sh | Adds a helper script to scan templates for hardcoded vs $.Path links. |
| docs/skills/muxt_explore/references/interactive-exploration.md | Adds a guide for generating and browsing a fake-server exploration app. |
| docs/skills/muxt_explore/references/structured-logging.md | Adds a guide for enabling structured request/error logging in generated handlers. |
| docs/skills/muxt_explore-from-route/SKILL.md | Deleted (replaced by consolidated muxt_explore). |
| docs/skills/muxt_explore-from-method/SKILL.md | Deleted (replaced by consolidated muxt_explore). |
| docs/skills/muxt_explore-from-error/SKILL.md | Deleted (replaced by consolidated muxt_explore). |
| docs/skills/muxt_explore-repo-overview/SKILL.md | Deleted (replaced by consolidated muxt_explore). |
| docs/skills/muxt_forms/SKILL.md | Refactors the forms skill into a shorter guide with pointers to full examples. |
| docs/skills/muxt_forms/references/examples.md | Adds comprehensive forms examples (struct mapping, accessibility, validation, multipart, tests). |
| docs/skills/muxt_htmx/SKILL.md | Refactors/shortens the HTMX skill and points to a new examples reference. |
| docs/skills/muxt_htmx/references/examples.md | Adds comprehensive HTMX examples (helpers, fragment chains, chromedp, inline validation, status codes). |
| docs/skills/muxt_integrate-existing-project/SKILL.md | Restructures integration guidance with “when to use” + streamlined steps. |
| docs/skills/muxt_maintain-tools/SKILL.md | Updates description and heading to broaden tool-maintenance scope. |
| docs/skills/muxt_refactoring/SKILL.md | Restructures refactoring guidance and points to a new examples reference. |
| docs/skills/muxt_refactoring/references/examples.md | Adds concrete refactoring walkthroughs and jq-based coupling analysis examples. |
| docs/skills/muxt_sqlc/SKILL.md | Refactors/shortens sqlc guidance with pointers to new examples reference. |
| docs/skills/muxt_sqlc/references/examples.md | Adds detailed sqlc examples (layouts, embedding, params alignment, PublishableError, DB testing, chromedp). |
| docs/skills/muxt_test-driven-development/SKILL.md | Refactors/shortens TDD guidance and points to a new examples reference. |
| docs/skills/muxt_test-driven-development/references/examples.md | Adds detailed TDD examples (template-first, method-first, type-checked URLs, decomposition, integration tests). |
| --- | ||
| name: muxt-htmx | ||
| description: "Muxt: Use when exploring, developing, or testing HTMX interactions in a Muxt codebase. Covers finding hx-* attributes, using --output-htmx-helpers, testing fragment chains, and verifying inter-route coupling." | ||
| description: "Muxt: Use when exploring, developing, or testing HTMX interactions in a Muxt codebase. Covers finding hx-* attributes, using --output-htmx-helpers, testing fragment chains, and verifying inter-route coupling. Distinct from muxt_datastar (data-* attributes / Datastar SSE) and muxt_forms (standard HTML form submission)." |
| | `muxt generate` | Type-checks AND generates handler code | Yes | | ||
| | `muxt check` | Type-checks only (read-only) | No | | ||
|
|
||
| `muxt check` only accepts `--use-templates-variable` and `--verbose`. It discovers types from the **already-generated code**, so run `muxt generate` first, then `muxt check`. |
check v0.2.0 drops the "type check failed:" prefix so errors start with file:line:col: for IDE jump-to-source, enriches not-found messages with "field or method X ... available: ..." and the receiver type's declared position, and adds a VerboseErrorer interface that renders the type's source declaration. muxt check now uses VerboseError when -v is set; plain muxt check stays single-line. Assisted-by: Claude:claude-opus-4-7
crhntr
force-pushed
the
skill-consolidation
branch
from
May 19, 2026 19:19
2178dec to
538d545
Compare
crhntr
marked this pull request as draft
August 18, 2026 00:34
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.