GitHub Copilot Instructions for Problem-Based SRS

Project Overview

This repository provides AgentSkills for following a Problem-Based Software Requirements Specification (SRS) methodology. The focus is on enabling AI-assisted requirements engineering through structured, problem-first approaches.

The repository follows the AgentSkills standard - an open format maintained by Anthropic for giving agents new capabilities and expertise.

Core Principles

Problem-First Thinking: Always identify the problem before proposing solutions
Lightweight Methodology: Favor simplicity over complex frameworks
AI-Native Design: Content designed for consumption by AI agents (following AgentSkills standard)
Practical Guidance: Focus on actionable skills and templates

When Working on This Repository

Skills Development (AgentSkills Format)

Skills are located in the
```
skills/
```
directory
Each skill has a
```
SKILL.md
```
file with YAML frontmatter (name, description, license)
Description field is critical - it determines when the skill triggers
Keep SKILL.md content under 500 lines (use references/ for detailed docs)
Follow the AgentSkills specification: https://agentskills.io/specification
Test skills by using them in practice

File Organization

skills/: AgentSkills format (Claude Code, Claude.ai, GitHub Copilot)
- Each skill is a self-contained directory with SKILL.md
- Can include optional subdirectories: scripts/, references/, assets/
docs/: Research papers and methodology documentation

Code Style

This is primarily a documentation repository
Any code examples should be language-agnostic where possible
Use clear, readable formatting in examples

Terminology

SRS: Software Requirements Specification
Problem-Based: Requirements methodology that starts with problem identification
Skill: A structured capability module designed for AI agent consumption (AgentSkills standard)
AI Agent: Tools like GitHub Copilot, Claude Code, or similar assistants

Quality Standards

Accuracy in requirements engineering concepts
Clarity in skill instructions
Completeness in examples and templates
Consistency in structure and formatting

Project Overview

The repository follows the AgentSkills standard - an open format maintained by Anthropic for giving agents new capabilities and expertise.

Core Principles

Problem-First Thinking: Always identify the problem before proposing solutions

Lightweight Methodology: Favor simplicity over complex frameworks

AI-Native Design: Content designed for consumption by AI agents (following AgentSkills standard)

Practical Guidance: Focus on actionable skills and templates

When Working on This Repository

Skills are located in the

skills/

directory

Each skill has a

SKILL.md

file with YAML frontmatter (name, description, license)

Description field is critical - it determines when the skill triggers

Keep SKILL.md content under 500 lines (use references/ for detailed docs)

Follow the AgentSkills specification: https://agentskills.io/specification

Test skills by using them in practice

skills/: AgentSkills format (Claude Code, Claude.ai, GitHub Copilot)

Each skill is a self-contained directory with SKILL.md
Can include optional subdirectories: scripts/, references/, assets/

docs/: Research papers and methodology documentation

This is primarily a documentation repository

Any code examples should be language-agnostic where possible

Use clear, readable formatting in examples

GitHub Copilot Instructions for Problem-Based SRS

GitHub Copilot Instructions for Problem-Based SRS

Project Overview

Core Principles

When Working on This Repository

Skills Development (AgentSkills Format)

File Organization

Code Style

Terminology

Quality Standards

Related Skills

Markdown Converter

Nano Banana Pro

1password

GitHub Copilot Instructions for Problem-Based SRS

Project Overview

Core Principles

When Working on This Repository

Skills Development (AgentSkills Format)

File Organization

Code Style

Terminology

Quality Standards