mallard

agent
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in install.sh
  • network request — Outbound network request in skills/gitlab-project-bootstrap/scripts/readiness-audit.py
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Claude Code, Codex & OpenCode toolkit for PrestaShop development — skills, commands & subagents, synced with one CLI.

README.md

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/ and
skills/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.

Reviews (0)

No results found