skills.rest
learnn-com
learnn-comOFFICIAL
Explore all skills by this author →
WebsiteGitHub

capability-write-issue

Creates or updates PM tool issues using type-specific templates and hierarchy linking.

Updated Mar 31, 2026
Search Tags:#template#project management#agile#issue tracking#epic#github projects#user story
One-click install
npx skills add https://github.com/learnn-com/engineering-kb --skill capability-write-issue-learnn-com
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: capability-write-issue
Source: https://github.com/learnn-com/engineering-kb/tree/main/.skills/capability-write-issue
Command: npx skills add https://github.com/learnn-com/engineering-kb --skill capability-write-issue-learnn-com

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually formatting and creating issues in project management tools is repetitive and inconsistent. This Skill standardizes issue creation and updates across story, task, epic, and initiative types by applying template-driven formatting and writing directly to the adopted PM tool. ## Core Features & Use Cases - Template-Driven Formatting: Reads type-specific templates (story, task, epic, initiative) and fills sections with structured content, preserving template structure. - Create or Update Modes: Creates new issues when no ID is given, or updates existing issues including project board status fields. - Hierarchy Linking: Links issues to parents (initiative → epic → story → task) and applies type-based labels per the PM tool implementation guide. - Use Case: After refining a user story, invoke this Skill with the story content and $status: Refined to update the issue body and transition its board status in GitHub Projects in one step. ## Quick Start Ask the AI to create a user story issue in the configured PM tool using the story template with your structured content.

Frequently Asked Questions about capability-write-issue

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

FAQPage Schema
How do I create a user story issue in GitHub Projects automatically?▼

Invoke the skill with type set to story and structured content matching the user story template sections. It reads the configured PM tool, formats the body from the template, creates the issue, and applies the appropriate label.

How do I update an existing issue status on a project board?▼

Pass the issue identifier as the id argument along with the status argument, such as Refined or In Progress. The skill updates the project board status field per the PM tool implementation guide, for example via GraphQL mutation for GitHub Projects.

Which PM tools does this issue writer support?▼

It supports any PM tool configured in way-of-working.md, with implementation guides available for github-projects and filesystem. Other tools like Jira or Linear work if a tool-specific implementation guide exists; otherwise it proceeds with default behavior.

What happens if no PM tool is configured?▼

The skill halts with an error directing you to configure the PM tool in way-of-working.md, either via the setup capability or manual editing. There is no fallback to alternative tools.

Can I link a story to a parent epic when creating it?▼

Yes, pass the parent issue identifier via the parent argument. The skill links the new issue to its parent following the hierarchy convention of initiative to epic to story to task, per the PM tool implementation guide.

Related Skills

Explore More Product & Management Skills→
foomakersfoomakers
6

write-issue

Create or update project management issues via API with template-driven formatting.

Official
Advanced
forrestthewoodsforrestthewoods

kanban-management

Organize and track GitHub issues across project board stages.

Community
Intermediate
ajrmooreukajrmooreuk

create-story

Create a GitHub Story issue linked to a parent Feature with SN.x.y formatting.

Community
Intermediate
SciMate-AISciMate-AI
71

hpc-ls-dyna

Create and review LS-DYNA keyword decks for simulation workflows.

Official
Advanced