@mohammadhprp/system-prompt 0.12.1 → 0.12.2

package/framework/agents/README.md

@@ -8,7 +8,6 @@ Subagents are focused AI agents that handle specific domains — security audits
 
 | Agent | Purpose | Permissions |
 | --- | --- | --- |
-| [Backend Architect](./backend-architect.md) | Design scalable, secure, and maintainable backend systems — APIs, databases, architecture, security, performance, DevOps. | read, bash, grep, glob, webfetch (no edit/write) |
 | [Researcher](./researcher.md) | Fetch and analyze web content from URLs — external documentation, best practices, API docs, online resources. | read, write, grep, glob, webfetch (no bash, no edit) |
 | [Reviewer](./reviewer.md) | Review code for correctness, maintainability, and best practices with focus on bugs. | read, bash, grep, glob (no edit/write) |
 | [Security Auditor](./security-auditor.md) | Conduct security audits for REST APIs — authentication, authorization, input validation, secrets, data protection, rate limiting. | read, bash, grep, glob, webfetch (no edit/write) |

package/framework/commands/mr.md

@@ -33,14 +33,13 @@ Create a merge request for the current branch.
    - Ask: "Shall I create this MR?"
    - Push the changes if user says Yes
 
-6. **Create upon confirmation** - Use `gitlab_create_merge_request`:
-   - `project_id`: `group/repo`
-   - `title`: Prepend "Draft: " to the formatted branch name
-   - `source_branch`: Current branch
-   - `target_branch`: `develop`
-   - `description`: Filled template content
-   - `assignee_ids`: `[1]`
-   - `squash`: `true`
-   - `remove_source_branch`: `true`
+6. **Create upon confirmation** - Use `glab mr create`:
+   - `--source-branch`: Current branch
+   - `--target-branch`: `develop`
+   - `--title`: Prepend "Draft: " to the formatted branch name
+   - `--description`: Filled template content
+   - `--assignee`: `1`
+   - `--squash`
+   - `--remove-source-branch`
 
 7. **Show the resulting URL.**

package/framework/mcps/README.md

@@ -10,9 +10,6 @@ This catalog is framework-agnostic: each entry documents what the server does, w
 | --- | --- | --- |
 | [Excalidraw MCP](./excalidraw/README.md) | Stream hand-drawn Excalidraw diagrams with interactive fullscreen editing — architecture diagrams, flowcharts, wireframes. | Any project that benefits from visual diagrams, architecture visualization, or design sketching. |
 | [Figma MCP Go](./figma-mcp-go/README.md) | Full read/write access to Figma designs via plugin bridge — no API token or rate limits. | Any project that works with Figma designs. |
-| [GitLab MCP](./gitlab-mcp/README.md) | Comprehensive GitLab integration — projects, MRs, issues, pipelines, wiki, milestones, and more. | Any project hosted on GitLab (SaaS or self-hosted). |
-| [GitHub MCP](./github-mcp/README.md) | Connect AI tools to GitHub — browse repos, manage issues and PRs, monitor Actions workflows. | Any project hosted on GitHub. |
-| [Jira MCP](./jira-mcp/README.md) | Interact with self-hosted Jira instances — issues, JQL search, comments, assignments, and projects. | Any project using self-hosted Jira for issue tracking. |
 | [Laravel Boost](./laravel-boost/README.md) | Gives AI agents Laravel application context, Laravel ecosystem documentation search, and safe local inspection tools. | Laravel applications. |
 | [Notion MCP](./notion-mcp/README.md) | Search, read, and write content in a Notion workspace — pages, databases, views, comments, and more via remote HTTP MCP. | Any project that uses Notion for documentation, tracking, or collaboration. |
 | [Playwright MCP](./playwright-mcp/README.md) | Cross-browser automation via accessibility snapshots — navigate, click, type, screenshot, evaluate, network control, storage management. | Any project needing browser automation or end-to-end testing. |

package/framework/skills/README.md

@@ -20,10 +20,11 @@ This catalog is framework-agnostic: each skill defines when to activate, a step-
 | [effective-html](./effective-html/SKILL.md) | Create self-contained HTML artifacts with routed guidance for design, wireframes, prototypes, plans, and diagrams. | Standalone HTML reports, explainers, interfaces, wireframes, prototypes, plans, and diagrams. |
 | [find-skills](./find-skills/SKILL.md) | Discover, evaluate, and install skills from the open agent skills ecosystem. | Finding an installable skill for a specialized task or extending an agent's capabilities. |
 | [frontend-design](./frontend-design/SKILL.md) | Distinctive, intentional visual design for new UI or reshaping existing UI — aesthetic direction, typography, and choices that don't read as templated defaults. | Building new interfaces, reshaping existing UI, or escaping generic AI-generated design looks. |
+| [glab](./glab/SKILL.md) | Use the GitLab CLI (glab) to manage merge requests, issues, pipelines, and repositories from the command line. | Any project hosted on GitLab (SaaS or self-hosted). |
 | [great-interface](./great-interface/SKILL.md) | Build, explain, review, and refine product interfaces across accessibility, layout, writing, typography, color, and UI polish. | Creating frontend interfaces, reviewing interface quality, explaining interface behavior, or comparing UI directions. |
-| [gitlab-mcp](./gitlab-mcp/SKILL.md) | Work with the GitLab MCP server tools for merge requests, issues, repositories, pipelines, and CI/CD workflows. | Any project hosted on GitLab (SaaS or self-hosted). |
 | [humanizer](./humanizer/SKILL.md) | Remove signs of AI-generated writing from text — inflated importance, promotional language, em dash overuse, rule of three, AI vocabulary, and filler phrases. | Editing or reviewing prose to make it sound more natural and human-written. |
-| [jira-mcp](./jira-mcp/SKILL.md) | Work with the Jira MCP server tools for issue management, JQL search, comments, and project inspection. | Any project using self-hosted Jira for issue tracking. |
+| [improve](./improve/SKILL.md) | Audit repositories as a read-only senior advisor and produce prioritized implementation plans for another agent. | Repository-wide audits, improvement roadmaps, and implementation handoffs. |
+| [jira-cli](./jira-cli/SKILL.md) | Use the Jira CLI (jira) to manage issues, sprints, epics, comments, transitions, and worklogs from the command line. | Any project using Jira (Cloud or self-hosted) for issue tracking. |
 | [laravel-best-practices](./laravel-best-practices/SKILL.md) | Apply Laravel PHP patterns for Eloquent, validation, security, testing, caching, and architecture. | Writing, reviewing, or refactoring Laravel PHP code. |
 | [learning-opportunities](./learning-opportunities/SKILL.md) | Facilitate deliberate skill development during AI-assisted coding with short, optional interactive exercises. | After architectural work, schema changes, refactors, or when the user asks to understand code better. |
 | [notion-mcp](./notion-mcp/SKILL.md) | Work with the Notion MCP server tools for pages, databases, comments, search, and workspace management. | Any project that uses Notion for documentation, tracking, or collaboration. |

package/framework/skills/glab/SKILL.md

@@ -0,0 +1,222 @@
+---
+name: glab
+description: Expert guidance for using the GitLab CLI (glab) to manage GitLab issues, merge requests, CI/CD pipelines, repositories, and other GitLab operations from the command line. Use this skill when the user needs to interact with GitLab resources or perform GitLab workflows.
+allowed-tools: Bash, Read, Grep, Glob
+---
+
+# GitLab CLI (glab) Skill
+
+Provides guidance for using `glab`, the official GitLab CLI, to perform GitLab operations from the terminal.
+
+## When to Use This Skill
+
+Invoke when the user needs to:
+- Create, review, or manage merge requests
+- Work with GitLab issues
+- Monitor or trigger CI/CD pipelines
+- Clone or manage repositories
+- Perform any GitLab operation from the command line
+
+## Prerequisites
+
+Verify glab installation before executing commands:
+```bash
+glab --version
+```
+
+If not installed, inform the user and provide platform-specific installation guidance.
+
+## Authentication Quick Start
+
+Most glab operations require authentication:
+
+```bash
+# Interactive authentication
+glab auth login
+
+# Check authentication status
+glab auth status
+
+# For self-hosted GitLab
+glab auth login --hostname gitlab.example.org
+
+# Using environment variables
+export GITLAB_TOKEN=your-token
+export GITLAB_HOST=gitlab.example.org  # for self-hosted
+```
+
+## Core Workflows
+
+### Creating a Merge Request
+
+```bash
+# 1. Ensure branch is pushed
+git push -u origin feature-branch
+
+# 2. Create MR
+glab mr create --title "Add feature" --description "Implements X"
+
+# With reviewers and labels
+glab mr create --title "Fix bug" --reviewer=alice,bob --label="bug,urgent"
+```
+
+### Reviewing Merge Requests
+
+```bash
+# 1. List MRs awaiting your review
+glab mr list --reviewer=@me
+
+# 2. Checkout MR locally to test
+glab mr checkout <mr-number>
+
+# 3. After testing, approve
+glab mr approve <mr-number>
+
+# 4. Add review comments
+glab mr note <mr-number> -m "Please update tests"
+```
+
+### Managing Issues
+
+```bash
+# Create issue with labels
+glab issue create --title "Bug in login" --label=bug
+
+# Link MR to issue
+glab mr create --title "Fix login" --description "Closes #<issue-number>"
+
+# List your assigned issues
+glab issue list --assignee=@me
+```
+
+### Monitoring CI/CD
+
+```bash
+# Watch pipeline in progress
+glab pipeline ci view
+
+# Check pipeline status
+glab ci status
+
+# View logs if failed
+glab ci trace
+
+# Retry failed pipeline
+glab ci retry
+
+# Lint CI config before pushing
+glab ci lint
+```
+
+## Common Patterns
+
+### Working Outside Repository Context
+
+When not in a Git repository, specify the repository:
+```bash
+glab mr list -R owner/repo
+glab issue list -R owner/repo
+```
+
+### Self-Hosted GitLab
+
+Set hostname for all commands:
+```bash
+export GITLAB_HOST=gitlab.example.org
+# or per-command
+glab repo clone gitlab.example.org/owner/repo
+```
+
+### Automation and Scripting
+
+Use JSON output for parsing:
+```bash
+glab mr list --output=json | jq '.[] | .title'
+```
+
+### Using the API Command
+
+The `glab api` command provides direct GitLab API access:
+
+```bash
+# Basic API call
+glab api projects/:id/merge_requests
+
+# IMPORTANT: Pagination uses query parameters in URL, NOT flags
+# ❌ WRONG: glab api --per-page=100 projects/:id/jobs
+# ✓ CORRECT: glab api "projects/:id/jobs?per_page=100"
+
+# Auto-fetch all pages
+glab api --paginate "projects/:id/pipelines/123/jobs?per_page=100"
+
+# POST with data
+glab api --method POST projects/:id/issues --field title="Bug" --field description="Details"
+```
+
+## Best Practices
+
+1. **Verify authentication** before executing commands: `glab auth status`
+2. **Use `--help`** to explore command options: `glab <command> --help`
+3. **Link MRs to issues** using "Closes #123" in MR description
+4. **Lint CI config** before pushing: `glab ci lint`
+5. **Check repository context** when commands fail: `git remote -v`
+
+## Common Commands Quick Reference
+
+**Merge Requests:**
+- `glab mr list --assignee=@me` - Your assigned MRs
+- `glab mr list --reviewer=@me` - MRs for you to review
+- `glab mr create` - Create new MR
+- `glab mr checkout <number>` - Test MR locally
+- `glab mr approve <number>` - Approve MR
+- `glab mr merge <number>` - Merge approved MR
+
+**Issues:**
+- `glab issue list` - List all issues
+- `glab issue create` - Create new issue
+- `glab issue close <number>` - Close issue
+
+**CI/CD:**
+- `glab pipeline ci view` - Watch pipeline
+- `glab ci status` - Check status
+- `glab ci lint` - Validate .gitlab-ci.yml
+- `glab ci retry` - Retry failed pipeline
+
+**Repository:**
+- `glab repo clone owner/repo` - Clone repository
+- `glab repo view` - View repo details
+- `glab repo fork` - Fork repository
+
+## Progressive Disclosure
+
+For detailed command documentation, refer to:
+- **references/commands-detailed.md** - Comprehensive command reference with all flags and options
+- **references/quick-reference.md** - Condensed command cheat sheet
+- **references/troubleshooting.md** - Detailed error scenarios and solutions
+
+Load these references when:
+- User needs specific flag or option details
+- Troubleshooting authentication or connection issues
+- Working with advanced features (API, schedules, variables, etc.)
+
+## Common Issues Quick Fixes
+
+**"command not found: glab"** - Install glab or verify PATH
+
+**"401 Unauthorized"** - Run `glab auth login`
+
+**"404 Project Not Found"** - Verify repository name and access permissions
+
+**"not a git repository"** - Navigate to repo or use `-R owner/repo` flag
+
+**"source branch already has a merge request"** - Use `glab mr list` to find existing MR
+
+For detailed troubleshooting, load **references/troubleshooting.md**.
+
+## Notes
+
+- glab auto-detects repository context from Git remote
+- Most commands have `--web` flag to open in browser
+- Use `--output=json` for scripting and automation
+- Multiple GitLab accounts can be authenticated simultaneously
+- Commands respect Git configuration and current repository context