propose-skill-edit

Convert staff feedback about skills into reviewable proposals with unified diff patches.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/alectivism/organization-ai-skills --skill propose-skill-edit-alectivism
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: propose-skill-edit
Source: https://github.com/alectivism/organization-ai-skills/tree/main/org-ops/skills/propose-skill-edit
Command: npx skills add https://github.com/alectivism/organization-ai-skills --skill propose-skill-edit-alectivism

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Staff who spot an error in an org's skills usually have no GitHub seat and no way to open a pull request, so their feedback arrives as vague prose that queues and dies. This Skill turns that feedback into a structured proposal bundle containing the problem, the fix, the evidence, and an applyable patch, then routes it through whatever channel the reporter actually has. ## Core Features & Use Cases - Locate and draft safely: Find the installed file for any skill, agent, or reference by name, then copy it to a scratch working copy so the live install is never edited. - Bundle with a real patch: Generate a proposal bundle with title, problem, fix, evidence, author, type (correction, addition, clarification, removal, bug), and a unified diff against the installed file. - Channel-aware submission: Detect which submission paths are available (Slack channel with Claude Tag, GitHub PR via gh, chat/project-tracker/email connectors) and pick the highest one that works. - Maintainer workflow: List pending proposals, dry-run check whether a patch still applies, and apply it to the working tree without staging or committing. - Use Case: A staff member says the document-find skill lists a retired SharePoint site. The agent locates the file, drafts the corrected copy, bundles it with evidence from a team call, and submits it to the maintainer, who applies it with one command. ## Quick Start Ask the agent to file a proposal saying the document-find skill lists a retired SharePoint site, with the correction and evidence, and submit it to the maintainer.

Frequently Asked Questions about propose-skill-edit

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

FAQPage Schema
How do I suggest a change to a skill without GitHub access?▼

Use the proposal flow: the helper script locates the installed skill file, copies it to a working draft, and bundles your problem description, fix, and evidence with a unified diff. The bundle is then submitted through Slack, a project tracker, or email to the maintainer.

How do I create a patch for an installed skill file?▼

Run the draft command to copy the target file to a scratch working copy, edit only that copy, then run bundle with the --edited flag. The script generates a unified diff with repo-relative paths and embeds it in the proposal bundle.

Can a maintainer apply a proposal patch automatically?▼

Yes. The maintainer runs the apply command on the bundle file, which extracts the diff block and applies it with git apply. A --check flag dry-runs the patch first, and the command refuses on conflict rather than forcing it.

What happens if a proposal patch no longer applies cleanly?▼

The apply command fails with a conflict message instead of forcing the patch, because the target file changed since the proposal was written. The maintainer then re-applies the intent by hand against the current file.

What makes a skill edit proposal likely to be accepted?▼

Keep one change per proposal, describe the concrete failure rather than a wording preference, and attach named evidence with a source and date for corrections to numbers, dates, or status fields. Bundles must not contain PII, contract terms, or embargoed material.