Provide a short workflow for authoring one validated skill
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 331
- Forks
- 22
- Avg merge
- 12h 17m
- Merged PRs (30d)
- 51
Description
Problem
Scaffold routes maintainers through domain discovery, tree generation, and skill generation with intermediate artifacts and review stops. The existing lightweight branch still requires loading a large discovery file.
Evidence
The first three shipped meta-skills total 90,780 bytes. Domain discovery has a lightweight path, but scaffold still prescribes the three-stage sequence.
Sources: scaffold, domain discovery.
Verified against main at 206e987 (@tanstack/intent 0.3.8), Node v24.12.0 on macOS arm64. Tests used installed dependencies and synthetic local fixtures.
Acceptance criteria
- Define a short path from one maintainer task to one validated SKILL.md.
- Load optional planning schemas, tables, and extensive examples only when needed.
- Keep the full-library authoring path available without forcing its artifacts onto the one-skill path.
- Demonstrate the short path on one small package and record the context it requires.
- Generated skills continue to satisfy existing validation and remain grounded in package source.
Scope and priority
Priority: Medium. Type: feature design.
Follow-up design, independent from repairing meta-skill validation. Do not delete advanced workflows or require a new artifact schema without a concrete need.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading packages/intent/src/commands/scaffold.ts and the domain-discovery SKILL.md, then compare the existing scaffold sequence with the lightweight discovery path. Demonstrate the proposed short path on one small package and record its required context. Done means the short path and full-library path both remain available, and generated skills pass existing validation while staying grounded in package source.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- node.js, typescript
- Domain
- cli, developer-experience, tooling
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100