Skills
.Work. You
Rest

write-local-user-stories

Community

Sync local user stories with ADO.

Product & Management#markdown#sync#prerequisites#user-stories#acceptance-criteria#azure-devops
Authorklemensms
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps teams keep locally authored user stories in sync with Azure DevOps by enforcing a consistent Markdown frontmatter and structure, reducing drift and manual rework.

Core Features & Use Cases

  • Enforces the required frontmatter and file layout for docs/user-stories/{id}.md so stories are machine- and human-friendly.
  • Guides and auto-fixes common formatting issues (Given/When/Then, acceptance criteria, prerequisites) to ensure consistency across stories.
  • Supports end-to-end workflow with MCP tooling to push and pull user stories between local files and Azure DevOps.
  • Includes templates and best-practices to avoid treating template placeholders as client requirements.

Quick Start

Create a new docs/user-stories/{id}.md with the required frontmatter and body, then push to Azure DevOps using the MCP sync tools.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: write-local-user-stories
Download link: https://github.com/klemensms/mcp-consultant-tools/archive/main.zip#write-local-user-stories

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.