mallard
Health Uyari
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Basarisiz
- rm -rf — Recursive force deletion command in install.sh
- network request — Outbound network request in skills/gitlab-project-bootstrap/scripts/readiness-audit.py
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Claude Code, Codex & OpenCode toolkit for PrestaShop development — skills, commands & subagents, synced with one CLI.
Mallard
Claude Code, Codex & OpenCode toolkit — skills, commands, and subagents,
synced with one CLI. Built for the day-to-day work of PrestaShop
development teams.
Website & docs → mallard.educalvolopez.com
Related tools
| Tool | What |
|---|---|
| ps-lando | CLI to scaffold a Lando environment with PrestaShop + Panda theme |
Note: the PrestaShop/Panda expert agents + knowledge base from
prestashop-experts are also bundled
here — see the Agents section below. The standalone plugin stays available
for external/freelance use; mallard is the team distribution.
Install
macOS / Linux (Homebrew)
brew install educlopez/tap/mallard
Upgrade later with brew upgrade mallard.
Windows (Scoop)
scoop bucket add educlopez https://github.com/educlopez/scoop-bucket
scoop install mallard
Upgrade later with scoop update mallard.
macOS / Linux (curl installer)
curl -fsSL https://raw.githubusercontent.com/educlopez/mallard/main/install.sh | bash
Drops the binary into ~/.local/bin/mallard (override with MALLARD_INSTALL_DIR=/usr/local/bin). Make sure ~/.local/bin is on your PATH.
Pin a specific version:
MALLARD_VERSION=v0.2.0 curl -fsSL https://raw.githubusercontent.com/educlopez/mallard/main/install.sh | bash
Windows (manual)
Grab the latest zip from Releases (mallard_<version>_windows_amd64.zip or _arm64.zip), extract it, and move mallard.exe somewhere on your PATH. Or use WSL / Git Bash with the curl installer above.
After install
mallard update # install skills, commands and sub-agents for every detected agent
mallard doctor # verify installation
mallard # launch interactive TUI
CLI
mallard # interactive TUI
mallard install # same as above
mallard install --agent claude # install only to claude (non-interactive)
mallard install --all # install to all detected agents (non-interactive)
mallard update # re-link skills/commands
mallard doctor # check symlink health per agent
mallard registry # list installed skills/commands
mallard version # print version
The binary auto-detects installed agents (claude, codex, opencode, agents,
gemini, cursor, windsurf) and symlinks the appropriate skills/commands
directories. Per-agent support varies: each agent only receives the kinds it
hosts.
| Agent | Skills | Commands | Sub-agents |
|---|---|---|---|
| Claude Code | ~/.claude/skills |
~/.claude/commands |
~/.claude/agents |
| Codex | ~/.agents/skills |
~/.codex/prompts (/prompts:<name>) |
~/.codex/agents/*.toml (rendered) |
| OpenCode | ~/.config/opencode/skills |
~/.config/opencode/commands |
~/.config/opencode/agents (rendered) |
| Cursor | ~/.cursor/skills |
~/.cursor/commands |
~/.cursor/agents (rendered) |
| Gemini CLI | ~/.gemini/skills |
— | — |
| Windsurf | ~/.codeium/windsurf/skills |
— | — |
| Generic | ~/.agents/skills |
— | — |
Everything is a symlink. Skills and commands link straight to the source.
Sub-agents for Codex, OpenCode and Cursor need a different format or
frontmatter, so mallard renders them from claude/agents/*.md into<source>/.generated/<agent>/agents/ on every install/update and links those.--scope workspace uses the project-level equivalents (.agents/skills,.codex/agents, .opencode/agents, .cursor/commands, ...). Older releases
linked Codex skills into ~/.codex/skills; mallard update removes those
stale links. Codex custom prompts are user-level only, so workspace scope
skips Codex commands. Several agents share ~/.agents/skills (Codex and the
generic adapter); mallard uninstall --agent X keeps any dir another detected
agent still uses.
From source
git clone [email protected]:educlopez/mallard.git
cd mallard
go build -o mallard .
./mallard update
Update
Re-run the curl-pipe installer to upgrade the binary, then re-link skills:
curl -fsSL https://raw.githubusercontent.com/educlopez/mallard/main/install.sh | bash
mallard update # re-link skills/commands (backs up conflicts)
Windows: download the latest zip from Releases and replace mallard.exe.
mallard update --list-backups and mallard update --restore <ts> recover prior state if anything went sideways.
Skills
| Skill | Trigger |
|---|---|
gitlab-security-setup |
Add Trivy + pnpm supply chain protection to GitLab projects (non-PS) |
lando-img-placeholder |
Static image placeholder for local Lando/PrestaShop dev |
ps-demo-user |
Create demo user in PrestaShop 8 (Lando) |
ps-security-audit |
Weekly CVE scan for PS projects: Friends of Presta module check + Trivy + core version |
ps-watch |
BrowserSync live-reload watcher for Panda child theme development in Lando |
panda-kb |
Knowledge base for the Panda theme by SunnyToo (st* modules, Easy Builder, demos) |
prestashop-kb |
Knowledge base for the PrestaShop 8/9 platform (Symfony, Twig BO, Smarty, hooks, migration) |
task-context |
Turn an Intervals task into a brief + git branch + route to the right skill; log time on finish (powers /task) |
ps-project-doc |
Generate a lean, team-shared AGENTS.md (40-line target, 80 cap, only what code does not show) plus a one-line CLAUDE.md bridge; private notes go to gitignored CLAUDE.local.md |
ps-new-project |
Scaffold a new PS client project: child theme (panda/elementflow) + CSS build + CLAUDE.md |
elementflow-kb |
Knowledge base for ElementFlow (Elementor-based builder, stsitebuilder) on PrestaShop |
gitlab-changelog-release |
Generate CHANGELOG.md and cut a GitLab release by hand (git-cliff or GitLab Changelog API) |
gitlab-ci-quality-gates |
Wire Cinetic CI components (lint, typecheck, tests, guardrails) and MR branch protection |
agents-md-completeness |
Verification pass for an existing AGENTS.md: checks it against a six-section outline, auto-detects what the repo answers (committers, languages, custom code, cron, tests, recent fixes) and proposes only the missing lines; stack-aware (PrestaShop, Magento, Laravel, custom), every check optional |
gitlab-project-bootstrap |
Set up or audit GitLab project metadata: avatar, description, topics, badges, README |
gitlab-wiki-bootstrap |
Bootstrap or extend a team GitLab Wiki from the real codebase |
lando-check |
Check local Lando is up and serving, start it, diagnose the usual failures |
lando-mail-smtp |
Route PrestaShop outgoing email to Lando's Mailhog |
lando-setup |
Set up a PrestaShop project locally with Lando, or refresh its DB from the server |
mallard-release |
Add skills/commands to mallard and ship a release |
mr-flow |
Branch, commit, push, open and merge a GitLab MR after detecting the base branch |
paginated-report-pdf |
Client-facing paginated PDF report (cover, sections, tables) |
ploi-prestashop-deploy |
Deploy a PrestaShop project from Lando to a Ploi server |
ps-console |
Run cache clears, bin/console and one-off scripts inside the Lando container |
ps-css-build |
CSS build pipeline for a PS child theme (partials, lightningcss, hooks) |
ps-theme-cache |
Make theme CSS/JS changes reach the browser when assets are combined in assets/cache (CCC) |
ps-email-preview |
Local email template viewer for PrestaShop |
ps-env-favicons |
Per-environment favicons for a PrestaShop shop (dev, preview, prod badges), configurable from the back office |
og-preview |
Static and animated link preview (og:image, og:video) from the site's real visuals, for Next, Laravel and PrestaShop |
ps-image-regen |
Fix white padding on product images and regenerate thumbnails safely |
ps-invoice-preview |
Local invoice PDF viewer for PrestaShop |
ps-one-page-checkout |
Enable, verify, style and translate the PS 9.2 one-page checkout |
ps-storefront-polish |
Polish method and reusable details for any PS 8/9 storefront theme |
ps-translate |
Detect and translate untranslated strings in a PS install, any language |
ps-view-transitions |
Add View Transitions to a PS child theme |
verify-ps-project |
Drive the local storefront (home, product, cart, checkout), capture evidence, keep the feature map honest |
skill-author |
Create or edit a mallard skill, command or agent: frontmatter, triggers, writing pass, lint |
reflect |
Turn a session's learnings into approved edits of existing skills |
blast-radius |
Find what a change could break outside the diff and prove the one safety fact |
no-comments |
Replace workaround comments in a diff with root-cause fixes |
show-me-your-work |
TSV decision trail for long or unattended work |
grill |
Decision-tree interview to stress-test a plan or estimate before starting |
diagnose-bug |
Repeatable feedback loop to find the cause of a hard bug (PrestaShop, Laravel, JS) before fixing |
task-review |
Review the branch diff against the Intervals brief and AGENTS.md before the MR |
Workflow
How the skills chain on one task, from Intervals to the MR: see docs/workflow.md.
Commands
| Command | What |
|---|---|
/lando |
Lando environment helpers |
/ps-customer |
Create test customer in PrestaShop |
/ps-url |
PrestaShop URL utilities |
/panda |
Ask the panda-expert agent (Panda theme + Easy Builder + st* modules) |
/ps |
Ask the prestashop-expert agent (PS 8/9 core: Symfony, Twig, Smarty, hooks, migration) |
/task |
Turn an Intervals task into ready-to-work context (brief, branch, route, time logging) |
/project-doc |
Generate a lean shared AGENTS.md for the current PS repo |
/new-project |
Scaffold day-1 setup for a new PS project (child theme, CSS build, docs) |
/sharpen |
Make a task deeper, not bigger, then rewrite the prompt |
/ketchup |
Catch up on what changed in this chat and what waits on you |
Agents
Claude Code subagents, symlinked to ~/.claude/agents/ (Claude only). The *-expert agents are
CWD-first (inspect project source before relying on KB snapshots) and consult the bundled *-kb skills.
| Agent | Domain |
|---|---|
panda-expert |
Panda theme by SunnyToo, st* modules, Easy Builder, SunnyToo demos |
prestashop-expert |
PrestaShop 8/9 core: themes, parent-child, Symfony BO, Twig, Smarty, hooks, modules, migration 8→9 |
task-classifier |
Classify an Intervals task into a work type to route it (used by /task) |
layout-builder |
Implement storefront layout/CSS on a PS child theme (Panda or ElementFlow) |
The knowledge base lives in-repo under skills/panda-kb/references/ andskills/prestashop-kb/references/ — that's the source of truth. Edit it directly; no
external vault or per-machine setup is required to build or ship the KB.
Structure
main.go Entry point + CLI routing
cmd/
install.go Install (TUI + non-interactive modes)
update.go Update with backup, restore, list-backups
doctor.go Doctor (thin delegate to internal/reports)
registry.go Registry (thin delegate to internal/reports)
internal/
agents/
adapter.go Multi-agent Adapter interface
claude.go codex.go Per-agent implementations
opencode.go generic.go
gemini.go cursor.go windsurf.go
registry.go All() / ByID() factory
backup/backup.go Snapshot/Restore + manifest, keep-latest-5 GC
updater/updater.go Pure Run(Options) → Report (CLI + TUI share it)
reports/ Writer-based doctor + registry renderers
skillregistry/registry.go Parse SKILL.md / command frontmatter
skills/skills.go Symlink helpers
tui/
model.go Bubbletea model + screen state machine
welcome.go Welcome screen calqued from gentle-ai
logo.go Braille-art duck + yellow gradient
styles.go Lipgloss palette (Rose Pine + duck accents)
skills/ Claude Code skills (symlinked to ~/.claude/skills/)
claude/commands/ Slash commands (symlinked to ~/.claude/commands/)
claude/agents/ Claude subagents (symlinked to ~/.claude/agents/, Claude only)
.github/workflows/
release.yml Tag push → goreleaser → binaries + brew + scoop
ci.yml go vet + go build on push/PR
pr-check.yml 400-line PR review-budget check
.goreleaser.yaml Multi-platform build + brews/scoops publish
install.sh Curl-pipe installer (downloads release binary)
doctor.sh Bash dependency check (claude CLI, node, pnpm)
docs/ Notes on adding skills, rules and the task workflow
Adding a skill
See docs/adding-skills.md. Rules and their checks: docs/skill-rules.md. Run make lint-skills before pushing.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi