write-shared-rules-and-skills

Qualify and author portable cross-project SmartKit Rules and Skills through the public workflow.

Updated May 19, 2026
One-click install
npx skills add https://github.com/wenyue/SmartKit --skill write-shared-rules-and-skills-wenyue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-shared-rules-and-skills
Source: https://github.com/wenyue/SmartKit/tree/main/.agents/skills/write-shared-rules-and-skills
Command: npx skills add https://github.com/wenyue/SmartKit --skill write-shared-rules-and-skills-wenyue

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It ensures that a Rule or Skill intended for cross-project reuse is properly qualified for portability before authoring, and that every portability obligation is verifiably closed at handoff, preventing project-local assumptions from leaking into shared artifacts. ## Core Features & Use Cases - Portability qualification: Judges ownership, provenance, and evidence to confirm a request is a genuinely portable cross-project Rule or Skill, routing project-local artifacts and Setup Authoring Contracts to their proper owners. - Public workflow delegation: Passes one closed portability input unchanged to the public write-rules-and-skills workflow and preserves its terminal result (COMPLETE, NEEDS_INPUT, or BLOCKED). - Handoff closure: Maintains a closure account binding every obligation to observable public outputs tied to the final Candidate fingerprint. - Use Case: A team wants to promote a project-specific linting Rule into a shared SmartKit Rule used across repositories; this Skill qualifies the request, authors it through the public workflow, and closes all portability obligations at handoff. ## Quick Start Use the write-shared-rules-and-skills skill to qualify and author this Rule as a portable cross-project SmartKit Rule.

Frequently Asked Questions about write-shared-rules-and-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I author a shared cross-project SmartKit Rule or Skill?▼

Qualify the request against the portability reference, close one complete portability input, then invoke the public write-rules-and-skills workflow with that input. At handoff, close every obligation from observable public outputs bound to the final Candidate fingerprint.

What makes a Rule or Skill portable across projects?▼

Portability requires a supported cross-project owner and independent provenance establishing shared meaning. Visibility, repository layout, packaging, or host injection locate evidence but do not by themselves establish portable meaning.

Can I use this Skill for project-local artifacts?▼

No. Project-local artifacts and Setup Authoring Contracts are explicitly excluded and routed to their supported owners. This Skill handles exactly one portable cross-project SmartKit Rule or Skill per run.

What happens when ownership or evidence is ambiguous?▼

Ambiguous, incompatible, or unresolved ownership follows the public NEEDS_INPUT route. The result names the missing choice, relevant evidence, decision owner, and material consequence rather than proceeding with an unclosed input.

Does this Skill publish or install the authored Rule or Skill?▼

No. It grants no publication, installation, commit, push, release, or other downstream effect. It only qualifies the request, delegates authoring to the public workflow, and closes portability obligations at handoff.