Problem Based SRS
An Agent Skill to use Problem-Based Software Requirements Specification (SRS) method in your software project.
Supply asset profile
Coding and developer agents
Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills.
Scenario
GitHub automation
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Agent fit
Claude Code + Browser agents + CLI
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add RafaelGorski/Problem-Based-SRS
Maintenance
fresh
15d since push
Risk
Needs review
Low GitHub adoption signal
GitHub quality
30
75/100 Quality · 77/100 Trust
Coverage tags
Review notes
Low GitHub adoption signal · Quality score needs review
Agent adoption scorecard
Trust, audit, and install readiness at a glance
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
StrongSolid option that is likely worth shortlisting for production workflows.
Trust
Sandbox onlyUseful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
Audit
Needs reviewA machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
OpenAgentSkill Trust Score v5
Human review before install
Run only in a sandbox and compare close alternatives before using it for real work.
Stars
30 GitHub stars
Repo activity
30 stars, 4 forks
Maintenance
15d since push
License
MIT
Install
npx skills add RafaelGorski/Problem-Based-SRS
Install safety
standard package or runtime install path
Permission surface
shell or command execution, network or browser access
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Review before production
- Low GitHub adoption signal
- Quality score needs review
- GitHub adoption: 30 GitHub stars
- Stars/forks activity: 30 stars, 4 forks; issue activity unavailable in current metadata
Install readiness
Install path available
- Install path is available
- Repository evidence is available
- License is declared
- No Agent Proven outcome evidence yet
Agent-readable metadata
Machine-readable decision data for this skill.
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
- GitHub automation workflows
- Claude Code teams
- builders willing to evaluate younger projects
- Inspect repository metadata
Suited agents
Install decision
- Command
- npx skills add RafaelGorski/Problem-Based-SRS
- Policy
- review
- Human review
- yes
Trust and risk
- Trust
- 69/100
- Audit
- 82/100
- Risk level
- Needs review
Outcome loop
- Endpoint
- /api/agent/outcome
- Event ID
- resolve
- Outcomes
- 5
Install command
npx skills add RafaelGorski/Problem-Based-SRSDo not use when
- teams that need a vendor-supported SLA
- production agents without a repository review
- Low GitHub adoption signal
- No OpenAgentSkill engagement data yet
- High-risk permission hints: Shell or command execution
Agent safety v2
54/100 · Avoid automatic install
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
high
Shell or command execution
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Browser automation
Skill may drive a browser or interact with web pages.
medium
Network access
Skill likely fetches remote pages, APIs, repositories, or external services.
- High-risk permission hints: Shell or command execution
- Low GitHub adoption signal
Install targets
Install this skill in your agent workflow
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
OpenAgentSkill CLI
Resolve policy, run the source installer safely, and report a verified install receipt.
$ npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install rafaelgorski-problem-based-srsAgent resolve plan
Let an agent verify fit before installing.
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Open JSON
/api/agent/resolve?task=Use%20Problem%20Based%20SRS%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20Problem%20Based%20SRS%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/rafaelgorski-problem-based-srs/install
Agent should check
- Task fit and alternatives from Resolve API.
- Audit score, trust score, and safety policy warnings.
- Install target compatibility for Codex, Claude Code, Cursor, or CLI.
Copy prompt
Task: Use Problem Based SRS in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20Problem%20Based%20SRS%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/rafaelgorski-problem-based-srs/install
Install command: npx skills add RafaelGorski/Problem-Based-SRS
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Give an agent the install path, not another directory page.
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/rafaelgorski-problem-based-srs/install
LLM text format
/api/skills/rafaelgorski-problem-based-srs/install?format=text
Find alternatives
/api/skills/search?q=Problem%20Based%20SRS&limit=3
Agent prompt
Use Problem Based SRS for this task. Review https://www.openagentskill.com/api/skills/rafaelgorski-problem-based-srs/install, then install with: npx skills add RafaelGorski/Problem-Based-SRSRegistry metadata
Agent-readable profile for automatic skill selection.
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/rafaelgorski-problem-based-srs
LLM text
/api/registry/manifest/rafaelgorski-problem-based-srs?format=text
Install alias
/api/registry/install/rafaelgorski-problem-based-srs
Recommend
/api/registry/recommend?task=Use%20Problem%20Based%20SRS%20in%20an%20agent%20workflow&limit=3
Agent fit
GitHub automation
Use-case tags
Platforms
JavaScript, Claude Code, Browser agents
Audit report
Needs review · 82/100
A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
Agent decision cockpit
Companion skill for GitHub automation
Shortlist this skill and compare it with close alternatives before production adoption.
Role in stack
Companion skill
Primary fit
GitHub automation
Trust label
Strong shortlist
Install path
Command ready
Use when
- GitHub automation workflows
- Claude Code teams
- builders willing to evaluate younger projects
Evidence
- recent repository activity
- install command or GitHub repo available
- 75/100 quality profile
review first
- Low GitHub adoption signal
- No OpenAgentSkill engagement data yet
Implementation path
- 1Install it in a sandbox agent and run one GitHub automation task end to end.
- 2Compare output quality, latency, and failure behavior against at least one alternative.
- 3Promote it into production only after reviewing repository permissions, license, and maintenance signals.
Trust profile
Sandbox only
Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
GitHub adoption
CHECK30 GitHub stars
Stars/forks activity
CHECK30 stars, 4 forks; issue activity unavailable in current metadata
Recent maintenance
PASS15d since push
License clarity
PASSMIT
Good signals
- AI review approved
- Install path is available
- Repository evidence is available
- Recently maintained repository
- Install command has no obvious high-risk pattern
- Outcome loop is ready but needs first real agent run
Review before install
- Low GitHub adoption signal
- Quality score needs review
- GitHub adoption: 30 GitHub stars
- Stars/forks activity: 30 stars, 4 forks; issue activity unavailable in current metadata
- No real agent outcome reports yet
- Human review required before unattended installation
Recommended action
Run only in a sandbox and compare close alternatives before using it for real work.
Quality profile
Strong candidate for agent workflows
Solid option that is likely worth shortlisting for production workflows.
Workflow fit
Use this skill in these scenarios
Manage repositories
GitHub automation
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Build and ship code
Coding agents
I need a coding agent that can understand a repository, edit code, and review pull requests.
Operate web apps
Browser automation
I need my agent to control a browser, fill forms, and verify web app workflows.
Workflow fit
Add it to a complete workflow
Operate and verify web apps
Browser QA agent
A workflow for agents that navigate products, fill forms, take screenshots, and verify real user flows across web applications.
Inspect, patch, and verify code
Coding review agent
A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.
Design, build, test, and ship interfaces
Frontend and UI
A practical workflow for agents that turn product briefs or Figma designs into polished frontend code, review the result, test it in a browser, and prepare a safe deployment.
Overview
# Problem-Based SRS
[](https://github.com/RafaelGorski/Problem-Based-SRS/releases) [](https://rafaelgorski.github.io/Problem-Based-SRS/skills-health.html) [](https://agentskills.io) [](https://opensource.org/licenses/MIT)
**Problem-Based SRS is a plugin that extends your AI harness to handle Software Specifications.** It plugs into GitHub Copilot first — and Claude Code and other AI coding assistants too — turning a general-purpose coding agent into one that can reason about, trace, and evolve requirements instead of just emitting code.
On top of your harness, the plugin adds three things:
| | What it adds | |---|--------------| | 🛡️ **AI‑slop prevention** | Guardrails tuned to the specific model that stop the agent from inventing features, skipping steps, or drifting off the actual problem. | | 🧭 **A spec language + command palette** | A shared vocabulary (Business Context → CP → CN → FR) and a `/problem-based-srs` command set that steer you toward great design, one decision at a time. | | 🌱 **A method for brownfield *and* greenfield** | A rigorous way to evolve existing systems (learn a spec from the code you inherited) as well as specify new ones from scratch. |
It traces every feature back to the customer problem it solves, using the [AgentSkills](https://agentskills.io) open standard.
**Don't take the anti-drift claim on faith — audit it.** Every push runs four suites (plugin validation, canvas unit tests, deterministic skill evals, and a Playwright visual suite) and publishes the result to the [**Skills Health Dashboard**](https://rafaelgorski.github.io/Problem-Based-SRS/skills-health.html). The snapshot is regenerated by `pwsh run-tests.ps1` and committ
Platform compatibility
Technical details
- Version
- 1.0.0
- License
- MIT
- Last updated
- Aug 18, 2026
- Published
- Aug 7, 2026
Frameworks & tools
Decision snapshot
Companion skill
recent repository activity
Audit
Install review
Install and adoption review
- Security
- 83/100
- Maintenance
- 100/100
- Install
- 92/100
Agent-proven evidence
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
- Success rate
- —
- Recent failure
- —
- Outcomes
- 0
- Output quality
- —
- Failed
- 0
- Not relevant
- 0
- Installs
- 0
- Risk blocked
- 0
- Setup needed
- 0
- Production
- 0
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Add to agent workflow
Free and open source. Review the report before installing into production agents.
Growth loop
Share kit
Scenario-led draft for Problem Based SRS, ready for a manual X post.
A practical pick for the next repo task: Problem Based SRS: An Agent Skill to use Problem-Based Software Requirements Specification (SRS) method in your software project. 30 stars https://www.openagentskill.com/skills/rafaelgorski-problem-based-srs?ref=x
Optional reply with install command
Listing + install path for Problem Based SRS: https://www.openagentskill.com/skills/rafaelgorski-problem-based-srs?ref=x Install: npx skills add RafaelGorski/Problem-Based-SRS
Listing source
Community indexed
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
- Creator
- RafaelGorski
- Indexed by
- OpenAgentSkill community index
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
Claim this skill listing
This Community indexed listing is attributed to RafaelGorski but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Add the evidence badges to your README
Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/rafaelgorski-problem-based-srs)
[](https://www.openagentskill.com/skills/rafaelgorski-problem-based-srs)
[](https://www.openagentskill.com/skills/rafaelgorski-problem-based-srs/audit)
[](https://www.openagentskill.com/skills/rafaelgorski-problem-based-srs)Author
RafaelGorski
@rafaelgorski
Platform fit
Health signals
- GitHub stars
- 30
- Quality score
- 47/100
- Last GitHub push
- Aug 7, 2026
- Framework hints
- 1
- OpenAgentSkill views
- 0
- Install copies
- 0
- Outbound clicks
- 0
Community signal
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Trust & safety
Sandbox only
- GitHub adoption30 GitHub starsCHECK
- Stars/forks activity30 stars, 4 forks; issue activity unavailable in current metadataCHECK
- Recent maintenance15d since pushPASS
- License clarityMITPASS
- README/SKILL.md completenessMetadata includes enough usage and workflow contextPASS
- Dependency/runtime risknetwork or browser surfacePASS