propose-a-skill

Evaluate procedures and draft reusable skill proposals for human review.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/AdamAwan/markdown-magpie --skill propose-a-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propose-a-skill
Source: https://github.com/AdamAwan/markdown-magpie/tree/main/.claude/skills/propose-a-skill
Command: npx skills add https://github.com/AdamAwan/markdown-magpie --skill propose-a-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you evaluate and capture valuable procedures from your work, ensuring they are reusable and documented for future reference.

Core Features & Use Cases

  • Skill Proposal: Decide whether a procedure is worth capturing as a skill.
  • Drafting: Create a draft skill based on the procedure, ready for human approval.
  • Criteria Assessment: Evaluates the procedure against criteria like repetition, non-obviousness, and cross-cutting nature.
  • Existing Skill Check: Ensures the proposed skill does not duplicate existing ones.

Quick Start

After completing a task, use the propose-a-skill skill to evaluate the procedure. If it meets the criteria, draft a skill proposal.

Frequently Asked Questions about propose-a-skill

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

FAQPage Schema
How do I decide if a work procedure is worth capturing as a reusable skill?

To decide if a work procedure is worth capturing as a reusable skill, evaluate it for repeated execution patterns, non-obvious complexity, and cross-cutting impact across your projects.

What is the best way to document work procedures for future code reuse?

The best way to document work procedures for code reuse is to draft a skill proposal that captures the task logic, ensuring it does not duplicate existing skills and is ready for human review.

How does skill drafting handle procedures with non-obvious complexity?

Skill drafting handles procedures with non-obvious complexity by assessing the task against specific criteria, isolating the intricate logic, and structuring it into a documented proposal for human oversight.

Can I check if a proposed skill duplicates existing ones before drafting?

Yes, you can check if a proposed skill duplicates existing ones before drafting, because the evaluation process explicitly ensures the new procedure does not overlap with previously captured skills.

When do I need human oversight for skill proposals?

You need human oversight for skill proposals after the procedure is evaluated and drafted, ensuring the final captured skill accurately reflects the work procedure before it is finalized for reuse.

Does capturing a skill require cross-cutting impact across multiple tasks?

Capturing a skill does not strictly require cross-cutting impact, but procedures demonstrating repeated execution, non-obvious complexity, and cross-cutting nature are prioritized as highly valuable for work documentation.