skill-creator-proposals

Manages meta-skill proposal CRUD operations under the OpenSquilla proposals directory.

6.8k|540|Updated May 6, 2026
One-click install
npx skills add https://github.com/opensquilla/opensquilla --skill skill-creator-proposals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator-proposals
Source: https://github.com/opensquilla/opensquilla/tree/main/src/opensquilla/skills/bundled/skill-creator-proposals
Command: npx skills add https://github.com/opensquilla/opensquilla --skill skill-creator-proposals

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Meta-skill creation pipelines need a safe, atomic way to stage candidate skills before they go live. This internal tool manages the lifecycle of skill proposals in ~/.opensquilla/proposals/, ensuring gated candidates are written, listed, and accepted without partial or orphaned state.

Core Features & Use Cases

  • Atomic Proposal Writes: Writes SKILL.md and gates.json to a temp directory, then renames into place so interrupted writes never leave orphan proposal folders.
  • Gate-Enforced Acceptance: The accept action moves a proposal into ~/.opensquilla/skills/ only if lint, smoke, and runtime E2E gates pass, unless explicitly forced.
  • JSON CLI Interface: Supports write_proposal, list, show, accept, reject, and pending_count actions, returning structured JSON for the meta-skill-creator pipeline and the opensquilla meta accept CLI.
  • Use Case: After the meta-skill-creator generates and lints a new skill, it calls write_proposal to stage the candidate; an operator later reviews pending proposals and accepts the passing ones into the managed skills layer.

Quick Start

Ask the agent to list all pending meta-skill proposals and accept the one that passed all gates.

Frequently Asked Questions about skill-creator-proposals

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

FAQPage Schema
How do I accept a pending skill proposal in OpenSquilla?

Run the accept action with the proposal ID, either through the opensquilla meta accept CLI or the proposals script. Acceptance moves the proposal into ~/.opensquilla/skills/ and is refused if any gate failed, unless you pass --force.

How does the proposal write avoid partial or corrupted state?

write_proposal first writes SKILL.md and gates.json into a temporary directory under ~/.opensquilla/.tmp/, then uses os.rename() to move it into the final proposals location. An interrupted write therefore never leaves an orphan proposal directory.

Can users invoke skill-creator-proposals directly from chat?

No, it is marked as not user-invocable with model invocation disabled. It is called internally by the meta-skill-creator persist step and the opensquilla meta accept CLI, though a manual fallback workflow is documented.

What gates must pass before a proposal can be accepted?

Proposals record lint and smoke test results in gates.json, and in FULL_GATED mode a runtime E2E result must show the meta-skill route wins or ties the no-meta baseline with no regressions. Accept refuses proposals with failed gates unless forced.

What are the limitations of the proposals tool?

It only manages proposals inside the OpenSquilla home directory and depends on the opensquilla package being importable. It does not generate or lint skills itself; those steps belong to the meta-skill-creator and linter components.