@mohammadhprp/system-prompt 0.12.1 → 0.12.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (173) hide show
  1. package/framework/agents/README.md +0 -1
  2. package/framework/commands/README.md +1 -1
  3. package/framework/commands/mr.md +8 -9
  4. package/framework/commands/review.md +1 -1
  5. package/framework/mcps/README.md +0 -4
  6. package/framework/plugins/ponytail/README.md +0 -1
  7. package/framework/plugins/ponytail/capabilities.md +1 -1
  8. package/framework/references/standards/api.md +0 -1
  9. package/framework/references/standards/architecture.md +0 -1
  10. package/framework/references/standards/database.md +0 -1
  11. package/framework/references/standards/debugging.md +0 -1
  12. package/framework/references/standards/documentation.md +0 -1
  13. package/framework/references/standards/logging.md +0 -1
  14. package/framework/references/standards/naming.md +0 -1
  15. package/framework/references/standards/observability.md +0 -1
  16. package/framework/references/standards/performance.md +0 -1
  17. package/framework/references/standards/pull-requests.md +0 -1
  18. package/framework/references/standards/security.md +0 -1
  19. package/framework/references/standards/testing.md +0 -1
  20. package/framework/skills/README.md +4 -14
  21. package/framework/skills/glab/SKILL.md +222 -0
  22. package/framework/skills/glab/references/commands-detailed.md +616 -0
  23. package/framework/skills/glab/references/quick-reference.md +145 -0
  24. package/framework/skills/glab/references/troubleshooting.md +669 -0
  25. package/framework/skills/improve/SKILL.md +135 -0
  26. package/framework/skills/improve/examples.md +19 -0
  27. package/framework/skills/improve/references/audit-playbook.md +130 -0
  28. package/framework/skills/improve/references/closing-the-loop.md +96 -0
  29. package/framework/skills/improve/references/plan-template.md +197 -0
  30. package/framework/skills/jira-cli/SKILL.md +260 -0
  31. package/framework/skills/jira-cli/references/commands-detailed.md +268 -0
  32. package/framework/skills/jira-cli/references/quick-reference.md +111 -0
  33. package/framework/skills/jira-cli/references/troubleshooting.md +114 -0
  34. package/framework/skills/laravel-best-practices/SKILL.md +56 -216
  35. package/framework/skills/laravel-best-practices/references/architecture.md +1 -1
  36. package/framework/skills/laravel-best-practices/references/checklist.md +139 -0
  37. package/framework/skills/laravel-best-practices/references/eloquent.md +4 -2
  38. package/framework/skills/laravel-best-practices/references/infer-conventions.md +97 -0
  39. package/framework/skills/laravel-best-practices/references/pest-testing.md +47 -18
  40. package/framework/skills/laravel-best-practices/references/security.md +1 -1
  41. package/framework/skills/laravel-best-practices/references/style.md +1 -1
  42. package/framework/skills/laravel-best-practices/references/tailwindcss.md +0 -1
  43. package/framework/styles/README.md +9 -4
  44. package/framework/styles/factory/DESIGN.md +360 -0
  45. package/framework/styles/factory/README.md +32 -0
  46. package/framework/styles/factory/assets/preview.jpg +0 -0
  47. package/framework/styles/huly/DESIGN.md +449 -0
  48. package/framework/styles/huly/README.md +32 -0
  49. package/framework/styles/huly/assets/preview.jpg +0 -0
  50. package/framework/styles/notion/DESIGN.md +423 -0
  51. package/framework/styles/notion/README.md +32 -0
  52. package/framework/styles/notion/assets/preview.jpg +0 -0
  53. package/package.json +1 -1
  54. package/src/catalog.js +7 -19
  55. package/framework/agents/backend-architect.md +0 -146
  56. package/framework/mcps/github-mcp/README.md +0 -51
  57. package/framework/mcps/github-mcp/capabilities.md +0 -83
  58. package/framework/mcps/github-mcp/configs/.env.example +0 -1
  59. package/framework/mcps/github-mcp/configs/opencode.json +0 -13
  60. package/framework/mcps/github-mcp/install.md +0 -60
  61. package/framework/mcps/github-mcp/troubleshooting.md +0 -79
  62. package/framework/mcps/gitlab-mcp/README.md +0 -53
  63. package/framework/mcps/gitlab-mcp/capabilities.md +0 -216
  64. package/framework/mcps/gitlab-mcp/configs/.env.example +0 -2
  65. package/framework/mcps/gitlab-mcp/configs/opencode.json +0 -13
  66. package/framework/mcps/gitlab-mcp/install.md +0 -99
  67. package/framework/mcps/gitlab-mcp/troubleshooting.md +0 -116
  68. package/framework/mcps/jira-mcp/README.md +0 -52
  69. package/framework/mcps/jira-mcp/capabilities.md +0 -79
  70. package/framework/mcps/jira-mcp/configs/.env.example +0 -2
  71. package/framework/mcps/jira-mcp/configs/opencode.json +0 -13
  72. package/framework/mcps/jira-mcp/install.md +0 -94
  73. package/framework/mcps/jira-mcp/troubleshooting.md +0 -113
  74. package/framework/mcps/notion-mcp/README.md +0 -57
  75. package/framework/mcps/notion-mcp/capabilities.md +0 -118
  76. package/framework/mcps/notion-mcp/configs/opencode.json +0 -9
  77. package/framework/mcps/notion-mcp/install.md +0 -70
  78. package/framework/mcps/notion-mcp/troubleshooting.md +0 -95
  79. package/framework/skills/brainstorming/SKILL.md +0 -159
  80. package/framework/skills/brainstorming/examples.md +0 -49
  81. package/framework/skills/brainstorming/scripts/frame-template.html +0 -213
  82. package/framework/skills/brainstorming/scripts/helper.js +0 -167
  83. package/framework/skills/brainstorming/scripts/server.cjs +0 -723
  84. package/framework/skills/brainstorming/scripts/start-server.sh +0 -209
  85. package/framework/skills/brainstorming/scripts/stop-server.sh +0 -120
  86. package/framework/skills/brainstorming/visual-companion.md +0 -291
  87. package/framework/skills/code-review/SKILL.md +0 -72
  88. package/framework/skills/code-review/examples.md +0 -31
  89. package/framework/skills/codenavi/SKILL.md +0 -306
  90. package/framework/skills/codenavi/examples.md +0 -33
  91. package/framework/skills/codenavi/references/coding-principles.md +0 -143
  92. package/framework/skills/codenavi/references/notebook-spec.md +0 -171
  93. package/framework/skills/create-adr/SKILL.md +0 -429
  94. package/framework/skills/create-adr/examples.md +0 -35
  95. package/framework/skills/design/SKILL.md +0 -399
  96. package/framework/skills/design/examples.md +0 -34
  97. package/framework/skills/gitlab-mcp/SKILL.md +0 -83
  98. package/framework/skills/gitlab-mcp/examples.md +0 -31
  99. package/framework/skills/gitlab-mcp/references/code-review.md +0 -110
  100. package/framework/skills/gitlab-mcp/references/issues.md +0 -141
  101. package/framework/skills/gitlab-mcp/references/merge-requests.md +0 -120
  102. package/framework/skills/gitlab-mcp/references/pipelines.md +0 -67
  103. package/framework/skills/gitlab-mcp/references/search.md +0 -17
  104. package/framework/skills/gitlab-mcp/references/webhooks.md +0 -32
  105. package/framework/skills/gitlab-mcp/references/work-items.md +0 -50
  106. package/framework/skills/great-interface/SKILL.md +0 -43
  107. package/framework/skills/great-interface/references/animations.md +0 -205
  108. package/framework/skills/great-interface/references/better-accessibility.md +0 -106
  109. package/framework/skills/great-interface/references/better-colors.md +0 -100
  110. package/framework/skills/great-interface/references/better-interface.md +0 -132
  111. package/framework/skills/great-interface/references/better-layout.md +0 -76
  112. package/framework/skills/great-interface/references/better-typography.md +0 -157
  113. package/framework/skills/great-interface/references/better-ui.md +0 -107
  114. package/framework/skills/great-interface/references/better-writing.md +0 -109
  115. package/framework/skills/great-interface/references/choosing-fonts.md +0 -64
  116. package/framework/skills/great-interface/references/color-formats.md +0 -90
  117. package/framework/skills/great-interface/references/color-usage.md +0 -118
  118. package/framework/skills/great-interface/references/contrast.md +0 -79
  119. package/framework/skills/great-interface/references/css-cheat-sheet.md +0 -65
  120. package/framework/skills/great-interface/references/details-and-accessibility.md +0 -119
  121. package/framework/skills/great-interface/references/enter-exit.md +0 -147
  122. package/framework/skills/great-interface/references/explain-interface.md +0 -126
  123. package/framework/skills/great-interface/references/find-the-effect.md +0 -94
  124. package/framework/skills/great-interface/references/focus-and-keyboard.md +0 -131
  125. package/framework/skills/great-interface/references/forms.md +0 -84
  126. package/framework/skills/great-interface/references/from-an-image.md +0 -55
  127. package/framework/skills/great-interface/references/grouping-and-alignment.md +0 -123
  128. package/framework/skills/great-interface/references/hit-areas.md +0 -94
  129. package/framework/skills/great-interface/references/icon-transitions.md +0 -102
  130. package/framework/skills/great-interface/references/icons.md +0 -110
  131. package/framework/skills/great-interface/references/interface-review.md +0 -148
  132. package/framework/skills/great-interface/references/motion-and-zoom.md +0 -79
  133. package/framework/skills/great-interface/references/no-browser.md +0 -73
  134. package/framework/skills/great-interface/references/palette-generation.md +0 -104
  135. package/framework/skills/great-interface/references/palette-structure.md +0 -76
  136. package/framework/skills/great-interface/references/performance.md +0 -88
  137. package/framework/skills/great-interface/references/picker.md +0 -76
  138. package/framework/skills/great-interface/references/read-the-system.md +0 -178
  139. package/framework/skills/great-interface/references/removed-signals.md +0 -38
  140. package/framework/skills/great-interface/references/review-format.md +0 -46
  141. package/framework/skills/great-interface/references/scope-resolution.md +0 -88
  142. package/framework/skills/great-interface/references/screen-readers.md +0 -101
  143. package/framework/skills/great-interface/references/semantics-and-aria.md +0 -84
  144. package/framework/skills/great-interface/references/spacing-and-adaptivity.md +0 -159
  145. package/framework/skills/great-interface/references/spacing-and-sizing.md +0 -121
  146. package/framework/skills/great-interface/references/surfaces.md +0 -219
  147. package/framework/skills/great-interface/references/token-naming.md +0 -97
  148. package/framework/skills/great-interface/references/variable-fonts-and-opentype.md +0 -105
  149. package/framework/skills/great-interface/references/variant.md +0 -104
  150. package/framework/skills/great-interface/references/wrapping-and-punctuation.md +0 -55
  151. package/framework/skills/jira-mcp/SKILL.md +0 -57
  152. package/framework/skills/jira-mcp/examples.md +0 -31
  153. package/framework/skills/jira-mcp/references/comments.md +0 -27
  154. package/framework/skills/jira-mcp/references/issues.md +0 -97
  155. package/framework/skills/jira-mcp/references/projects.md +0 -39
  156. package/framework/skills/learning-opportunities/SKILL.md +0 -140
  157. package/framework/skills/learning-opportunities/examples.md +0 -34
  158. package/framework/skills/learning-opportunities/references/PRINCIPLES.md +0 -42
  159. package/framework/skills/notion-mcp/SKILL.md +0 -57
  160. package/framework/skills/notion-mcp/examples.md +0 -31
  161. package/framework/skills/notion-mcp/references/comments.md +0 -112
  162. package/framework/skills/notion-mcp/references/databases.md +0 -193
  163. package/framework/skills/notion-mcp/references/pages.md +0 -235
  164. package/framework/skills/spec-driven-eval/SKILL.md +0 -341
  165. package/framework/skills/spec-driven-eval/examples.md +0 -35
  166. package/framework/skills/spec-driven-eval/references/quickstart.md +0 -118
  167. package/framework/skills/spec-driven-eval/references/reference.md +0 -295
  168. package/framework/skills/technical-design-doc-creator/README.md +0 -411
  169. package/framework/skills/technical-design-doc-creator/SKILL.md +0 -1484
  170. package/framework/skills/technical-design-doc-creator/examples.md +0 -35
  171. package/framework/skills/web-design-guidelines/SKILL.md +0 -65
  172. package/framework/skills/web-design-guidelines/examples.md +0 -32
  173. package/framework/skills/web-design-guidelines/references/guideline.md +0 -174
@@ -8,7 +8,6 @@ Subagents are focused AI agents that handle specific domains — security audits
8
8
 
9
9
  | Agent | Purpose | Permissions |
10
10
  | --- | --- | --- |
11
- | [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) |
12
11
  | [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) |
13
12
  | [Reviewer](./reviewer.md) | Review code for correctness, maintainability, and best practices with focus on bugs. | read, bash, grep, glob (no edit/write) |
14
13
  | [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) |
@@ -14,7 +14,7 @@ Commands define repeatable workflows that agents execute on demand, triggered by
14
14
  | [`/pr`](./pr.md) | Create a GitHub PR for the current branch. | pull-requests standard |
15
15
  | [`/mr`](./mr.md) | Create a GitLab MR for the current branch. | pull-requests standard |
16
16
  | [`/release`](./release.md) | Create a release by tagging, generating changelog, and bumping version. | — |
17
- | [`/review`](./review.md) | Perform comprehensive code quality review. | code-review skill, naming/testing/security/performance standards |
17
+ | [`/review`](./review.md) | Perform comprehensive code quality review. | naming/testing/security/performance standards |
18
18
  | [`/summarize-changes`](./summarize-changes.md) | Summarize uncommitted changes and flag risky patterns. | — |
19
19
 
20
20
  ## Command Entry Structure
@@ -33,14 +33,13 @@ Create a merge request for the current branch.
33
33
  - Ask: "Shall I create this MR?"
34
34
  - Push the changes if user says Yes
35
35
 
36
- 6. **Create upon confirmation** - Use `gitlab_create_merge_request`:
37
- - `project_id`: `group/repo`
38
- - `title`: Prepend "Draft: " to the formatted branch name
39
- - `source_branch`: Current branch
40
- - `target_branch`: `develop`
41
- - `description`: Filled template content
42
- - `assignee_ids`: `[1]`
43
- - `squash`: `true`
44
- - `remove_source_branch`: `true`
36
+ 6. **Create upon confirmation** - Use `glab mr create`:
37
+ - `--source-branch`: Current branch
38
+ - `--target-branch`: `develop`
39
+ - `--title`: Prepend "Draft: " to the formatted branch name
40
+ - `--description`: Filled template content
41
+ - `--assignee`: `1`
42
+ - `--squash`
43
+ - `--remove-source-branch`
45
44
 
46
45
  7. **Show the resulting URL.**
@@ -9,7 +9,7 @@ Perform comprehensive code quality review.
9
9
 
10
10
  ## Process
11
11
 
12
- 1. **Review conversation and diff** - Read conversation history, run `git diff` for staged/unstaged changes, identify the problem being solved and the behavior being modified. Load [`skills/code-review/SKILL.md`](../skills/code-review/SKILL.md) and related standards: [`references/standards/naming.md`](../references/standards/naming.md), [`references/standards/testing.md`](../references/standards/testing.md), [`references/standards/security.md`](../references/standards/security.md), [`references/standards/performance.md`](../references/standards/performance.md).
12
+ 1. **Review conversation and diff** - Read conversation history, run `git diff` for staged/unstaged changes, identify the problem being solved and the behavior being modified. Read related standards: [`references/standards/naming.md`](../references/standards/naming.md), [`references/standards/testing.md`](../references/standards/testing.md), [`references/standards/security.md`](../references/standards/security.md), [`references/standards/performance.md`](../references/standards/performance.md).
13
13
 
14
14
  2. **Check correctness** - Edge cases, concurrency, error handling, state transitions, backward compatibility. Read contracts and interfaces before implementation.
15
15
 
@@ -10,11 +10,7 @@ This catalog is framework-agnostic: each entry documents what the server does, w
10
10
  | --- | --- | --- |
11
11
  | [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. |
12
12
  | [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. |
13
- | [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). |
14
- | [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. |
15
- | [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. |
16
13
  | [Laravel Boost](./laravel-boost/README.md) | Gives AI agents Laravel application context, Laravel ecosystem documentation search, and safe local inspection tools. | Laravel applications. |
17
- | [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. |
18
14
  | [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. |
19
15
  | [Supabase MCP](./supabase-mcp/README.md) | Manage Supabase projects, query databases, design schema, run migrations, deploy Edge Functions, manage Auth/Storage/Realtime, and search docs. | Any project using Supabase as backend. |
20
16
 
@@ -39,6 +39,5 @@ Avoid when the task explicitly needs complex scaffolding, heavy abstractions, or
39
39
 
40
40
  Relevant skills in this repository:
41
41
 
42
- - [`code-review`](../../skills/code-review/SKILL.md): review backend changes for correctness and maintainability, complementary to ponytail's over-engineering focus.
43
42
  - [`backend-best-practices`](../../skills/backend-best-practices/SKILL.md): backend best practices for refactoring and behavior-preserving cleanup.
44
43
  - [`pr`](../../commands/pr.md): prepare small, reviewable changes aligned with ponytail's minimal-diff philosophy.
@@ -90,7 +90,7 @@ Or in `~/.config/ponytail/config.json` (`%APPDATA%\ponytail\config.json` on Wind
90
90
  - Use `/ponytail-review` after a coding session to catch over-engineering the agent missed.
91
91
  - Mark intentional shortcuts with `ponytail:` comments naming the ceiling and upgrade path.
92
92
  - Review `/ponytail-debt` regularly to track deferred improvements.
93
- - Pair with `code-review` and the `/pr` command for a complete quality workflow.
93
+ - Pair with the `/pr` command for a complete quality workflow.
94
94
 
95
95
  ## Common Workflows
96
96
 
@@ -39,5 +39,4 @@ Define reusable backend engineering rules for API decisions across projects. Thi
39
39
 
40
40
  ## Related Skills
41
41
 
42
- - `skills/code-review/SKILL.md`
43
42
  - `skills/backend-best-practices/references/api-design.md`
@@ -38,5 +38,4 @@ Define reusable backend engineering rules for architecture decisions across proj
38
38
 
39
39
  ## Related Skills
40
40
 
41
- - `skills/code-review/SKILL.md`
42
41
  - `skills/backend-best-practices/references/architecture-review.md`
@@ -38,5 +38,4 @@ Define reusable backend engineering rules for database decisions across projects
38
38
 
39
39
  ## Related Skills
40
40
 
41
- - `skills/code-review/SKILL.md`
42
41
  - `skills/backend-best-practices/references/database-design.md`
@@ -39,5 +39,4 @@ Define reusable backend engineering rules for debugging decisions across project
39
39
 
40
40
  ## Related Skills
41
41
 
42
- - `skills/code-review/SKILL.md`
43
42
  - `skills/backend-best-practices/references/debugging.md`
@@ -38,4 +38,3 @@ Define reusable backend engineering rules for documentation decisions across pro
38
38
 
39
39
  ## Related Skills
40
40
 
41
- - `skills/code-review/SKILL.md`
@@ -38,5 +38,4 @@ Define reusable backend engineering rules for logging decisions across projects.
38
38
 
39
39
  ## Related Skills
40
40
 
41
- - `skills/code-review/SKILL.md`
42
41
  - `skills/backend-best-practices/references/observability.md`
@@ -38,5 +38,4 @@ Define reusable backend engineering rules for naming decisions across projects.
38
38
 
39
39
  ## Related Skills
40
40
 
41
- - `skills/code-review/SKILL.md`
42
41
  - `skills/backend-best-practices/references/refactoring.md`
@@ -38,5 +38,4 @@ Define reusable backend engineering rules for observability decisions across pro
38
38
 
39
39
  ## Related Skills
40
40
 
41
- - `skills/code-review/SKILL.md`
42
41
  - `skills/backend-best-practices/references/observability.md`
@@ -38,5 +38,4 @@ Define reusable backend engineering rules for performance decisions across proje
38
38
 
39
39
  ## Related Skills
40
40
 
41
- - `skills/code-review/SKILL.md`
42
41
  - `skills/backend-best-practices/references/performance.md`
@@ -38,5 +38,4 @@ Define reusable backend engineering rules for pull request decisions across proj
38
38
 
39
39
  ## Related Skills
40
40
 
41
- - `skills/code-review/SKILL.md`
42
41
  - `commands/pr.md`
@@ -38,5 +38,4 @@ Define reusable backend engineering rules for security decisions across projects
38
38
 
39
39
  ## Related Skills
40
40
 
41
- - `skills/code-review/SKILL.md`
42
41
  - `skills/backend-best-practices/references/security.md`
@@ -38,5 +38,4 @@ Define reusable backend engineering rules for testing decisions across projects.
38
38
 
39
39
  ## Related Skills
40
40
 
41
- - `skills/code-review/SKILL.md`
42
41
  - `skills/backend-best-practices/references/testing.md`
@@ -10,33 +10,23 @@ This catalog is framework-agnostic: each skill defines when to activate, a step-
10
10
  | --- | --- | --- |
11
11
  | [agent-browser](./agent-browser/SKILL.md) | Automate browser and Electron workflows for navigation, testing, screenshots, and data extraction. | Website interaction, browser automation, exploratory testing, QA, and Electron desktop app workflows. |
12
12
  | [backend-best-practices](./backend-best-practices/SKILL.md) | Consolidated backend engineering practices for API design, architecture, data, security, testing, observability, performance, debugging, and refactoring. | Any backend task that benefits from structured domain guidance across multiple backend disciplines. |
13
- | [brainstorming](./brainstorming/SKILL.md) | Turn ideas into fully formed designs and specs through collaborative dialogue before any implementation. | Starting a new feature, component, or project; any work that benefits from design before code. |
14
- | [code-review](./code-review/SKILL.md) | Review backend changes for correctness, readability, maintainability, tests, performance, and security. | Reviewing pull requests, evaluating code quality, or mentoring. |
15
- | [codenavi](./codenavi/SKILL.md) | Investigate unfamiliar codebases with precision, implement surgically, and keep a `.notebook/` knowledge base that grows across sessions. | Fixing bugs, implementing features, refactoring, or investigating flows in unfamiliar territory. |
16
- | [create-adr](./create-adr/SKILL.md) | Create Architecture Decision Records (ADRs) that capture the context, decision, and consequences of significant architectural choices. | Documenting a finalized technical decision, or recording why a choice was made for future team members. |
17
- | [design-like-damien](./design/SKILL.md) | Apply premium, editorial-quality UI design philosophy and Lovable prompting system to produce interfaces that never look “AI-generated.” | Building apps, landing pages, or dashboards in Lovable; UI/UX design for premium SaaS, dark mode, typography, and scroll animations. |
18
13
  | [diagram-design](./diagram-design/SKILL.md) | Create technical and product diagrams as standalone HTML files with inline SVG and an opinionated editorial design system. | Architecture, data, process, and other diagrams that communicate more clearly than prose or tables. |
19
14
  | [docs-writer](./docs-writer/SKILL.md) | Write, review, and edit documentation files with consistent structure, tone, and technical accuracy. | Creating docs, reviewing markdown files, writing READMEs, or updating `/docs` directories. |
20
15
  | [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. |
21
16
  | [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. |
22
17
  | [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. |
23
- | [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. |
24
- | [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). |
18
+ | [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). |
25
19
  | [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. |
26
- | [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. |
20
+ | [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. |
21
+ | [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. |
27
22
  | [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. |
28
- | [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. |
29
- | [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. |
30
23
  | [perf-web-optimization](./perf-web-optimization/SKILL.md) | Optimize web performance: bundle size, images, caching, lazy loading, and overall page speed. | A slow site, large bundles, layout shifts, poor Time to Interactive, or low Lighthouse scores. |
31
24
  | [security-best-practices](./security-best-practices/SKILL.md) | Perform language- and framework-specific security best-practice reviews and suggest improvements, with support for Python, JavaScript/TypeScript, and Go. | Explicit security reviews or reports, secure-by-default coding, or auditing existing code for major vulnerabilities. |
32
25
  | [sentry](./sentry/SKILL.md) | Inspect Sentry issues, summarize production errors, and pull health data via the Sentry API (read-only). | Checking production errors, summarizing recent crashes, or pulling a production error report. |
33
26
  | [show-me](./show-me/SKILL.md) | Help the user understand the current topic visually with concise diagrams, code-shape sketches, and focused HTML artifacts. | Explaining logic, control flow, UI structure, file responsibility, or data flow with the smallest useful visual. |
34
27
  | [skill-creator](./skill-creator/SKILL.md) | Create new skills, modify and improve existing skills, and measure skill performance. | Designing new skills, optimizing existing skills, or running evals. |
35
- | [spec-driven-eval](./spec-driven-eval/SKILL.md) | Score how completely an implementation fulfills a PRD/spec, case by case, producing a single comparable final grade. | Benchmarking spec-driven implementations, grading acceptance criteria, or auditing implementation and test coverage against a spec. |
36
- | [technical-design-doc-creator](./technical-design-doc-creator/SKILL.md) | Create comprehensive Technical Design Documents (TDDs) with mandatory and optional sections through interactive discovery, in the user's language. | Writing a design doc, TDD, technical spec, or architecture document before implementing a significant change. |
37
28
  | [tlc-spec-driven](./tlc-spec-driven/SKILL.md) | Feature planning and implementation with adaptive phases, EARS testable requirements, atomic Conventional Commits, and independent verification. | Planning features, implementing with verification and atomic commits, or validating an implementation against a spec. |
38
29
  | [taste](./taste/SKILL.md) | Unified design-quality skill spanning anti-slop frontend design, image generation and image-to-code, brand kits, minimalist and industrial UI, redesigns, and Google Stitch design systems. | Landing pages, portfolios, redesigns, website/mobile/brand imagery, or any UI that must not look AI-generated. |
39
- | [web-design-guidelines](./web-design-guidelines/SKILL.md) | Review UI code for Web Interface Guidelines compliance — accessibility, focus, forms, animation, typography, and interaction patterns. | Reviewing UI, checking accessibility, auditing design or UX, or checking a site against best practices. |
40
30
 
41
31
  ## How Skills Are Organized
42
32
 
@@ -59,7 +49,7 @@ Use the skill table above to find the entry closest to the task at hand. Skills
59
49
  Before activating a skill, check:
60
50
 
61
51
  - **Fit**: does the skill's purpose match the current task?
62
- - **Scope**: some skills are general (CodeNavi), others are narrow (Laravel Best Practices).
52
+ - **Scope**: some skills are general, others are narrow (Laravel Best Practices).
63
53
  - **Combination**: complex tasks may need multiple skills (e.g., API Design + Security + Testing).
64
54
  - **Sequence**: some skills are best used in order (e.g., Architecture Review before Database Design).
65
55
 
@@ -0,0 +1,222 @@
1
+ ---
2
+ name: glab
3
+ 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.
4
+ allowed-tools: Bash, Read, Grep, Glob
5
+ ---
6
+
7
+ # GitLab CLI (glab) Skill
8
+
9
+ Provides guidance for using `glab`, the official GitLab CLI, to perform GitLab operations from the terminal.
10
+
11
+ ## When to Use This Skill
12
+
13
+ Invoke when the user needs to:
14
+ - Create, review, or manage merge requests
15
+ - Work with GitLab issues
16
+ - Monitor or trigger CI/CD pipelines
17
+ - Clone or manage repositories
18
+ - Perform any GitLab operation from the command line
19
+
20
+ ## Prerequisites
21
+
22
+ Verify glab installation before executing commands:
23
+ ```bash
24
+ glab --version
25
+ ```
26
+
27
+ If not installed, inform the user and provide platform-specific installation guidance.
28
+
29
+ ## Authentication Quick Start
30
+
31
+ Most glab operations require authentication:
32
+
33
+ ```bash
34
+ # Interactive authentication
35
+ glab auth login
36
+
37
+ # Check authentication status
38
+ glab auth status
39
+
40
+ # For self-hosted GitLab
41
+ glab auth login --hostname gitlab.example.org
42
+
43
+ # Using environment variables
44
+ export GITLAB_TOKEN=your-token
45
+ export GITLAB_HOST=gitlab.example.org # for self-hosted
46
+ ```
47
+
48
+ ## Core Workflows
49
+
50
+ ### Creating a Merge Request
51
+
52
+ ```bash
53
+ # 1. Ensure branch is pushed
54
+ git push -u origin feature-branch
55
+
56
+ # 2. Create MR
57
+ glab mr create --title "Add feature" --description "Implements X"
58
+
59
+ # With reviewers and labels
60
+ glab mr create --title "Fix bug" --reviewer=alice,bob --label="bug,urgent"
61
+ ```
62
+
63
+ ### Reviewing Merge Requests
64
+
65
+ ```bash
66
+ # 1. List MRs awaiting your review
67
+ glab mr list --reviewer=@me
68
+
69
+ # 2. Checkout MR locally to test
70
+ glab mr checkout <mr-number>
71
+
72
+ # 3. After testing, approve
73
+ glab mr approve <mr-number>
74
+
75
+ # 4. Add review comments
76
+ glab mr note <mr-number> -m "Please update tests"
77
+ ```
78
+
79
+ ### Managing Issues
80
+
81
+ ```bash
82
+ # Create issue with labels
83
+ glab issue create --title "Bug in login" --label=bug
84
+
85
+ # Link MR to issue
86
+ glab mr create --title "Fix login" --description "Closes #<issue-number>"
87
+
88
+ # List your assigned issues
89
+ glab issue list --assignee=@me
90
+ ```
91
+
92
+ ### Monitoring CI/CD
93
+
94
+ ```bash
95
+ # Watch pipeline in progress
96
+ glab pipeline ci view
97
+
98
+ # Check pipeline status
99
+ glab ci status
100
+
101
+ # View logs if failed
102
+ glab ci trace
103
+
104
+ # Retry failed pipeline
105
+ glab ci retry
106
+
107
+ # Lint CI config before pushing
108
+ glab ci lint
109
+ ```
110
+
111
+ ## Common Patterns
112
+
113
+ ### Working Outside Repository Context
114
+
115
+ When not in a Git repository, specify the repository:
116
+ ```bash
117
+ glab mr list -R owner/repo
118
+ glab issue list -R owner/repo
119
+ ```
120
+
121
+ ### Self-Hosted GitLab
122
+
123
+ Set hostname for all commands:
124
+ ```bash
125
+ export GITLAB_HOST=gitlab.example.org
126
+ # or per-command
127
+ glab repo clone gitlab.example.org/owner/repo
128
+ ```
129
+
130
+ ### Automation and Scripting
131
+
132
+ Use JSON output for parsing:
133
+ ```bash
134
+ glab mr list --output=json | jq '.[] | .title'
135
+ ```
136
+
137
+ ### Using the API Command
138
+
139
+ The `glab api` command provides direct GitLab API access:
140
+
141
+ ```bash
142
+ # Basic API call
143
+ glab api projects/:id/merge_requests
144
+
145
+ # IMPORTANT: Pagination uses query parameters in URL, NOT flags
146
+ # ❌ WRONG: glab api --per-page=100 projects/:id/jobs
147
+ # ✓ CORRECT: glab api "projects/:id/jobs?per_page=100"
148
+
149
+ # Auto-fetch all pages
150
+ glab api --paginate "projects/:id/pipelines/123/jobs?per_page=100"
151
+
152
+ # POST with data
153
+ glab api --method POST projects/:id/issues --field title="Bug" --field description="Details"
154
+ ```
155
+
156
+ ## Best Practices
157
+
158
+ 1. **Verify authentication** before executing commands: `glab auth status`
159
+ 2. **Use `--help`** to explore command options: `glab <command> --help`
160
+ 3. **Link MRs to issues** using "Closes #123" in MR description
161
+ 4. **Lint CI config** before pushing: `glab ci lint`
162
+ 5. **Check repository context** when commands fail: `git remote -v`
163
+
164
+ ## Common Commands Quick Reference
165
+
166
+ **Merge Requests:**
167
+ - `glab mr list --assignee=@me` - Your assigned MRs
168
+ - `glab mr list --reviewer=@me` - MRs for you to review
169
+ - `glab mr create` - Create new MR
170
+ - `glab mr checkout <number>` - Test MR locally
171
+ - `glab mr approve <number>` - Approve MR
172
+ - `glab mr merge <number>` - Merge approved MR
173
+
174
+ **Issues:**
175
+ - `glab issue list` - List all issues
176
+ - `glab issue create` - Create new issue
177
+ - `glab issue close <number>` - Close issue
178
+
179
+ **CI/CD:**
180
+ - `glab pipeline ci view` - Watch pipeline
181
+ - `glab ci status` - Check status
182
+ - `glab ci lint` - Validate .gitlab-ci.yml
183
+ - `glab ci retry` - Retry failed pipeline
184
+
185
+ **Repository:**
186
+ - `glab repo clone owner/repo` - Clone repository
187
+ - `glab repo view` - View repo details
188
+ - `glab repo fork` - Fork repository
189
+
190
+ ## Progressive Disclosure
191
+
192
+ For detailed command documentation, refer to:
193
+ - **references/commands-detailed.md** - Comprehensive command reference with all flags and options
194
+ - **references/quick-reference.md** - Condensed command cheat sheet
195
+ - **references/troubleshooting.md** - Detailed error scenarios and solutions
196
+
197
+ Load these references when:
198
+ - User needs specific flag or option details
199
+ - Troubleshooting authentication or connection issues
200
+ - Working with advanced features (API, schedules, variables, etc.)
201
+
202
+ ## Common Issues Quick Fixes
203
+
204
+ **"command not found: glab"** - Install glab or verify PATH
205
+
206
+ **"401 Unauthorized"** - Run `glab auth login`
207
+
208
+ **"404 Project Not Found"** - Verify repository name and access permissions
209
+
210
+ **"not a git repository"** - Navigate to repo or use `-R owner/repo` flag
211
+
212
+ **"source branch already has a merge request"** - Use `glab mr list` to find existing MR
213
+
214
+ For detailed troubleshooting, load **references/troubleshooting.md**.
215
+
216
+ ## Notes
217
+
218
+ - glab auto-detects repository context from Git remote
219
+ - Most commands have `--web` flag to open in browser
220
+ - Use `--output=json` for scripting and automation
221
+ - Multiple GitLab accounts can be authenticated simultaneously
222
+ - Commands respect Git configuration and current repository context