skills.rest
mariadb-corporation
mariadb-corporationOFFICIAL
Explore all skills by this author →
WebsiteGitHub

propose-improvement

Files DOCS Jira tasks and drafts proposal markdown for agent-tooling improvements.

28|115|Updated Jan 28, 2025
Search Tags:#workflow#documentation#JIRA#atlassian#skill#proposal#agent tooling
One-click install
npx skills add https://github.com/mariadb-corporation/mariadb-docs --skill propose-improvement-mariadb-corporation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: propose-improvement
Source: https://github.com/mariadb-corporation/mariadb-docs/tree/main/.claude/skills/propose-improvement
Command: npx skills add https://github.com/mariadb-corporation/mariadb-docs --skill propose-improvement-mariadb-corporation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Proposing a new Claude Code skill or agent-tooling change requires filing a Jira ticket, numbering a proposal document, and writing structured content — a manual process that is easy to skip or do inconsistently. ## Core Features & Use Cases - Dual-branch workflow: Classifies the proposal as a new skill or a general agent-tooling improvement, then follows the matching naming, numbering, and section structure. - Jira integration: Creates a DOCS Task labeled claude-skill via the Atlassian MCP connection, assigned to the proposer, with a short markdown description. - Interview-based drafting: Writes the proposal MD (dev-docs/skill-proposals/ or dev-docs/agent-improvements/) by interviewing the proposer section by section, never fabricating content. - Use Case: A team member says "propose a new skill called changelog-writer" and gets a numbered proposal MD plus a linked DOCS Jira ticket, ready for a discussion-first PR. ## Quick Start Ask the assistant to propose an improvement or propose a new skill, then answer the classification and interview questions it asks.

Frequently Asked Questions about propose-improvement

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

FAQPage Schema
How do I propose a new Claude Code skill for a docs repository?▼

Say "propose a new skill" and provide a kebab-case name. The workflow validates the name, assigns the next NNNN number, files a DOCS Jira Task labeled claude-skill, and interviews you to fill each proposal section.

How do I file a Jira ticket for an agent-tooling improvement?▼

Describe the problem and proposed direction in one turn. The skill derives a slug, creates a DOCS Task with a short markdown description, and writes the full proposal to dev-docs/agent-improvements/.

Does this skill open the pull request for the proposal?▼

No, it only files the Jira ticket and writes the proposal markdown. You open the PR yourself afterward and reference the DOCS ticket from the PR description.

What happens if the Jira connection fails during filing?▼

The skill enters manual-Jira mode: it scaffolds the proposal MD with a DOCS-XXXX placeholder on the Related tickets line and tells you to file the ticket manually as a DOCS Task labeled claude-skill.

Can the skill write proposal content on my behalf?▼

No, the proposer is the source of every body word. The skill asks open-ended questions section by section, quotes answers verbatim, and marks skipped sections as TBD rather than inventing content.

Related Skills

Explore More Software Engineering Skills→
fartybobofartybobo
4

create-jira-ticket

Create Jira tickets from conversation and code context in Atlassian Document Format.

Official
Advanced
CybernetKZCybernetKZ

feature-flow

Orchestrates YouTrack ticket intake through spec-driven planning, testing, and PR delivery.

Official
Advanced
SkuNexus-DevsSkuNexus-Devs

skunexus-bug-hunt

Investigate bug reports into evidence-backed verdicts with proposed fixes and acceptance criteria.

Official
Advanced
talhayilmazaitalhayilmazai

jira-manager

Create, update, and query Jira tickets from code changes and tasks.

Community
Intermediate