@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.
- package/framework/agents/README.md +0 -1
- package/framework/commands/README.md +1 -1
- package/framework/commands/mr.md +8 -9
- package/framework/commands/review.md +1 -1
- package/framework/mcps/README.md +0 -4
- package/framework/plugins/ponytail/README.md +0 -1
- package/framework/plugins/ponytail/capabilities.md +1 -1
- package/framework/references/standards/api.md +0 -1
- package/framework/references/standards/architecture.md +0 -1
- package/framework/references/standards/database.md +0 -1
- package/framework/references/standards/debugging.md +0 -1
- package/framework/references/standards/documentation.md +0 -1
- package/framework/references/standards/logging.md +0 -1
- package/framework/references/standards/naming.md +0 -1
- package/framework/references/standards/observability.md +0 -1
- package/framework/references/standards/performance.md +0 -1
- package/framework/references/standards/pull-requests.md +0 -1
- package/framework/references/standards/security.md +0 -1
- package/framework/references/standards/testing.md +0 -1
- package/framework/skills/README.md +4 -14
- package/framework/skills/glab/SKILL.md +222 -0
- package/framework/skills/glab/references/commands-detailed.md +616 -0
- package/framework/skills/glab/references/quick-reference.md +145 -0
- package/framework/skills/glab/references/troubleshooting.md +669 -0
- package/framework/skills/improve/SKILL.md +135 -0
- package/framework/skills/improve/examples.md +19 -0
- package/framework/skills/improve/references/audit-playbook.md +130 -0
- package/framework/skills/improve/references/closing-the-loop.md +96 -0
- package/framework/skills/improve/references/plan-template.md +197 -0
- package/framework/skills/jira-cli/SKILL.md +260 -0
- package/framework/skills/jira-cli/references/commands-detailed.md +268 -0
- package/framework/skills/jira-cli/references/quick-reference.md +111 -0
- package/framework/skills/jira-cli/references/troubleshooting.md +114 -0
- package/framework/skills/laravel-best-practices/SKILL.md +56 -216
- package/framework/skills/laravel-best-practices/references/architecture.md +1 -1
- package/framework/skills/laravel-best-practices/references/checklist.md +139 -0
- package/framework/skills/laravel-best-practices/references/eloquent.md +4 -2
- package/framework/skills/laravel-best-practices/references/infer-conventions.md +97 -0
- package/framework/skills/laravel-best-practices/references/pest-testing.md +47 -18
- package/framework/skills/laravel-best-practices/references/security.md +1 -1
- package/framework/skills/laravel-best-practices/references/style.md +1 -1
- package/framework/skills/laravel-best-practices/references/tailwindcss.md +0 -1
- package/framework/styles/README.md +9 -4
- package/framework/styles/factory/DESIGN.md +360 -0
- package/framework/styles/factory/README.md +32 -0
- package/framework/styles/factory/assets/preview.jpg +0 -0
- package/framework/styles/huly/DESIGN.md +449 -0
- package/framework/styles/huly/README.md +32 -0
- package/framework/styles/huly/assets/preview.jpg +0 -0
- package/framework/styles/notion/DESIGN.md +423 -0
- package/framework/styles/notion/README.md +32 -0
- package/framework/styles/notion/assets/preview.jpg +0 -0
- package/package.json +1 -1
- package/src/catalog.js +7 -19
- package/framework/agents/backend-architect.md +0 -146
- package/framework/mcps/github-mcp/README.md +0 -51
- package/framework/mcps/github-mcp/capabilities.md +0 -83
- package/framework/mcps/github-mcp/configs/.env.example +0 -1
- package/framework/mcps/github-mcp/configs/opencode.json +0 -13
- package/framework/mcps/github-mcp/install.md +0 -60
- package/framework/mcps/github-mcp/troubleshooting.md +0 -79
- package/framework/mcps/gitlab-mcp/README.md +0 -53
- package/framework/mcps/gitlab-mcp/capabilities.md +0 -216
- package/framework/mcps/gitlab-mcp/configs/.env.example +0 -2
- package/framework/mcps/gitlab-mcp/configs/opencode.json +0 -13
- package/framework/mcps/gitlab-mcp/install.md +0 -99
- package/framework/mcps/gitlab-mcp/troubleshooting.md +0 -116
- package/framework/mcps/jira-mcp/README.md +0 -52
- package/framework/mcps/jira-mcp/capabilities.md +0 -79
- package/framework/mcps/jira-mcp/configs/.env.example +0 -2
- package/framework/mcps/jira-mcp/configs/opencode.json +0 -13
- package/framework/mcps/jira-mcp/install.md +0 -94
- package/framework/mcps/jira-mcp/troubleshooting.md +0 -113
- package/framework/mcps/notion-mcp/README.md +0 -57
- package/framework/mcps/notion-mcp/capabilities.md +0 -118
- package/framework/mcps/notion-mcp/configs/opencode.json +0 -9
- package/framework/mcps/notion-mcp/install.md +0 -70
- package/framework/mcps/notion-mcp/troubleshooting.md +0 -95
- package/framework/skills/brainstorming/SKILL.md +0 -159
- package/framework/skills/brainstorming/examples.md +0 -49
- package/framework/skills/brainstorming/scripts/frame-template.html +0 -213
- package/framework/skills/brainstorming/scripts/helper.js +0 -167
- package/framework/skills/brainstorming/scripts/server.cjs +0 -723
- package/framework/skills/brainstorming/scripts/start-server.sh +0 -209
- package/framework/skills/brainstorming/scripts/stop-server.sh +0 -120
- package/framework/skills/brainstorming/visual-companion.md +0 -291
- package/framework/skills/code-review/SKILL.md +0 -72
- package/framework/skills/code-review/examples.md +0 -31
- package/framework/skills/codenavi/SKILL.md +0 -306
- package/framework/skills/codenavi/examples.md +0 -33
- package/framework/skills/codenavi/references/coding-principles.md +0 -143
- package/framework/skills/codenavi/references/notebook-spec.md +0 -171
- package/framework/skills/create-adr/SKILL.md +0 -429
- package/framework/skills/create-adr/examples.md +0 -35
- package/framework/skills/design/SKILL.md +0 -399
- package/framework/skills/design/examples.md +0 -34
- package/framework/skills/gitlab-mcp/SKILL.md +0 -83
- package/framework/skills/gitlab-mcp/examples.md +0 -31
- package/framework/skills/gitlab-mcp/references/code-review.md +0 -110
- package/framework/skills/gitlab-mcp/references/issues.md +0 -141
- package/framework/skills/gitlab-mcp/references/merge-requests.md +0 -120
- package/framework/skills/gitlab-mcp/references/pipelines.md +0 -67
- package/framework/skills/gitlab-mcp/references/search.md +0 -17
- package/framework/skills/gitlab-mcp/references/webhooks.md +0 -32
- package/framework/skills/gitlab-mcp/references/work-items.md +0 -50
- package/framework/skills/great-interface/SKILL.md +0 -43
- package/framework/skills/great-interface/references/animations.md +0 -205
- package/framework/skills/great-interface/references/better-accessibility.md +0 -106
- package/framework/skills/great-interface/references/better-colors.md +0 -100
- package/framework/skills/great-interface/references/better-interface.md +0 -132
- package/framework/skills/great-interface/references/better-layout.md +0 -76
- package/framework/skills/great-interface/references/better-typography.md +0 -157
- package/framework/skills/great-interface/references/better-ui.md +0 -107
- package/framework/skills/great-interface/references/better-writing.md +0 -109
- package/framework/skills/great-interface/references/choosing-fonts.md +0 -64
- package/framework/skills/great-interface/references/color-formats.md +0 -90
- package/framework/skills/great-interface/references/color-usage.md +0 -118
- package/framework/skills/great-interface/references/contrast.md +0 -79
- package/framework/skills/great-interface/references/css-cheat-sheet.md +0 -65
- package/framework/skills/great-interface/references/details-and-accessibility.md +0 -119
- package/framework/skills/great-interface/references/enter-exit.md +0 -147
- package/framework/skills/great-interface/references/explain-interface.md +0 -126
- package/framework/skills/great-interface/references/find-the-effect.md +0 -94
- package/framework/skills/great-interface/references/focus-and-keyboard.md +0 -131
- package/framework/skills/great-interface/references/forms.md +0 -84
- package/framework/skills/great-interface/references/from-an-image.md +0 -55
- package/framework/skills/great-interface/references/grouping-and-alignment.md +0 -123
- package/framework/skills/great-interface/references/hit-areas.md +0 -94
- package/framework/skills/great-interface/references/icon-transitions.md +0 -102
- package/framework/skills/great-interface/references/icons.md +0 -110
- package/framework/skills/great-interface/references/interface-review.md +0 -148
- package/framework/skills/great-interface/references/motion-and-zoom.md +0 -79
- package/framework/skills/great-interface/references/no-browser.md +0 -73
- package/framework/skills/great-interface/references/palette-generation.md +0 -104
- package/framework/skills/great-interface/references/palette-structure.md +0 -76
- package/framework/skills/great-interface/references/performance.md +0 -88
- package/framework/skills/great-interface/references/picker.md +0 -76
- package/framework/skills/great-interface/references/read-the-system.md +0 -178
- package/framework/skills/great-interface/references/removed-signals.md +0 -38
- package/framework/skills/great-interface/references/review-format.md +0 -46
- package/framework/skills/great-interface/references/scope-resolution.md +0 -88
- package/framework/skills/great-interface/references/screen-readers.md +0 -101
- package/framework/skills/great-interface/references/semantics-and-aria.md +0 -84
- package/framework/skills/great-interface/references/spacing-and-adaptivity.md +0 -159
- package/framework/skills/great-interface/references/spacing-and-sizing.md +0 -121
- package/framework/skills/great-interface/references/surfaces.md +0 -219
- package/framework/skills/great-interface/references/token-naming.md +0 -97
- package/framework/skills/great-interface/references/variable-fonts-and-opentype.md +0 -105
- package/framework/skills/great-interface/references/variant.md +0 -104
- package/framework/skills/great-interface/references/wrapping-and-punctuation.md +0 -55
- package/framework/skills/jira-mcp/SKILL.md +0 -57
- package/framework/skills/jira-mcp/examples.md +0 -31
- package/framework/skills/jira-mcp/references/comments.md +0 -27
- package/framework/skills/jira-mcp/references/issues.md +0 -97
- package/framework/skills/jira-mcp/references/projects.md +0 -39
- package/framework/skills/learning-opportunities/SKILL.md +0 -140
- package/framework/skills/learning-opportunities/examples.md +0 -34
- package/framework/skills/learning-opportunities/references/PRINCIPLES.md +0 -42
- package/framework/skills/notion-mcp/SKILL.md +0 -57
- package/framework/skills/notion-mcp/examples.md +0 -31
- package/framework/skills/notion-mcp/references/comments.md +0 -112
- package/framework/skills/notion-mcp/references/databases.md +0 -193
- package/framework/skills/notion-mcp/references/pages.md +0 -235
- package/framework/skills/spec-driven-eval/SKILL.md +0 -341
- package/framework/skills/spec-driven-eval/examples.md +0 -35
- package/framework/skills/spec-driven-eval/references/quickstart.md +0 -118
- package/framework/skills/spec-driven-eval/references/reference.md +0 -295
- package/framework/skills/technical-design-doc-creator/README.md +0 -411
- package/framework/skills/technical-design-doc-creator/SKILL.md +0 -1484
- package/framework/skills/technical-design-doc-creator/examples.md +0 -35
- package/framework/skills/web-design-guidelines/SKILL.md +0 -65
- package/framework/skills/web-design-guidelines/examples.md +0 -32
- 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. |
|
|
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
|
package/framework/commands/mr.md
CHANGED
|
@@ -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 `
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
- `
|
|
43
|
-
- `
|
|
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.
|
|
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
|
|
package/framework/mcps/README.md
CHANGED
|
@@ -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
|
|
93
|
+
- Pair with the `/pr` command for a complete quality workflow.
|
|
94
94
|
|
|
95
95
|
## Common Workflows
|
|
96
96
|
|
|
@@ -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
|
-
| [
|
|
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
|
-
| [
|
|
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
|
|
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
|