Agent skill

Deploy

by notque in notque/vexjoy-agent

Deploy and infrastructure: web deploy, dev branches, cron, package install, shell configuration.

MITAuto-check: notesProductivity & Automation

Install Deploy

skills CLI
$ npx skills add notque/vexjoy-agent --skill deploy -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install notque/vexjoy-agent deploy --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/notque/vexjoy-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/infrastructure/deploy .claude/skills/deploy && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
deploy
GitHub stars
438
Token cost
~2.6k tokens
SKILL.md length
934 words
Files
25 (incl. references)
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

Deploy and infrastructure: web deploy, dev branches, cron, package install, shell configuration.

  • Works in 5 steps: DNS: Create A/AAAA record. Verify: dig… → Web Server: nginx server block with… → HTTPS: certbot --nginx -d . Verify… → …
  • Tasks that involve Scheduled and recurring tasks
  • SKILL.md covers A. Public Web Deploy, B. Dev-Branch Deploy, C. Cron Automation and D. Headless Cron Creator, plus 4 more sections
  • Calls python3, curl and git

What it does

Deploy is an agent skill from notque/vexjoy-agent. Deploy and infrastructure: web deploy, dev branches, cron, package install, shell configuration.

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 25 other files, including reference files (for example `references/cleanup-verification.md`, `references/concurrency-and-locks.md` and `references/cron-automation.md`).

It sits in Productivity & Automation, covering Scheduled and recurring tasks. It works with NGINX. The repository describes itself as: VexJoy AI Agent with Jev Intelligent Routing - /do routes plain-English requests to the right specialist agent and gates the work with reviews, tests, and a learning loop. The licence is MIT.

When your agent uses it

  • Tasks that involve Scheduled and recurring tasks

Example prompts

  • “/deploy”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Read, Write, Bash, Grep, Glob, Edit, Agent

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. DNS: Create A/AAAA record. Verify: dig +short A . Gate: resolves to intended IP.
  2. Web Server: nginx server block with explicit docroot. Backend proxied to 127.0.0.1. Test: nginx -t && systemctl reload nginx.
  3. HTTPS: certbot --nginx -d . Verify renewal: certbot renew --dry-run. Verify redirect: curl -sI http:// | grep -iE '301|308'.
  4. Hardening: Firewall (ufw allow 80/443/SSH only), nginx deny rules (location ~ /. { deny all; }), security headers (HSTS…
  5. Verify: Run the 13-item security checklist. Spot-check: curl -s https:///.env -w '%{http_code}\n' (expect 403/404), ss -tlnp (no app ports…

What it can do on your machine

Read from SKILL.md and the folder at commit 5218674. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Bash
    • Grep
    • Glob
    • Edit
    • Agent

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3
    • curl
    • git
    • fly
    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Deploy loads about 2.6k tokens when it runs, and up to ~54k if it reads all its reference files. Until then it costs about 26 tokens; SKILL.md has 934 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~54k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:86
    ist. Spot-check: `curl -s https://<fqdn>/.env -w '%{http_code}\n'` (expect 403/404), `ss -tlnp` (no app ports public).
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Bash, Grep, Glob, Edit, Agent

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from notque/vexjoy-agent at commit 5218674, republished under its MIT licence (© notque). 934 words, ~2,556 tokens.

Download SKILL.mdSave it as .claude/skills/deploy/SKILL.md (or your agent's skills folder). This skill also uses 24 other files; get the full folder from GitHub.
name
deploy
description
Deploy and infrastructure: web deploy, dev branches, cron, package install, shell configuration.
allowed-tools
Read, Write, Bash, Grep, Glob, Edit, Agent
user-invocable
true
routing.force_route
true
routing.not_for
Kubernetes or Helm (use kubernetes skill), Ansible (agents handle directly), code review (use review), security scanning (use security)
routing.triggers
deploy website, deploy site, go live, public site, public website, static site, landing page, make it public, make public, set up https, nginx public site…
routing.category
infrastructure
routing.pairs_with
assessment, kubernetes, pr-workflow

Deploy Skill

Six modes. Match the request to a section.

SignalSection
Deploy site, HTTPS, nginx, go live, public siteA. Public Web Deploy
Dev branch, Concourse dev lane, hermes/maiaB. Dev-Branch Deploy
Cron job, scheduled task, audit cron scriptC. Cron Automation
Headless agent, wrapper script, recurring Claude taskD. Headless Cron Creator
Install toolkit, verify setup, health checkE. Toolkit Install
Fish shell, Zsh, shell config, migrationF. Shell Configuration
Background process, nohup, trap, PID, signalsG. Process Management

When the request spans modes, compose the relevant sections.


A. Public Web Deploy

Serve public sites through nginx/Caddy/Apache -- never a raw dev server. Local preview binds 127.0.0.1; public sites require HTTPS + hardened nginx.

5-phase workflow: DNS -> Web Server -> HTTPS -> Hardening -> Verify.

  1. DNS: Create A/AAAA record. Verify: dig +short A <fqdn>. Gate: resolves to intended IP.
  2. Web Server: nginx server block with explicit docroot. Backend proxied to 127.0.0.1. Test: nginx -t && systemctl reload nginx.
  3. HTTPS: certbot --nginx -d <fqdn>. Verify renewal: certbot renew --dry-run. Verify redirect: curl -sI http://<fqdn> | grep -iE '301|308'.
  4. Hardening: Firewall (ufw allow 80/443/SSH only), nginx deny rules (location ~ /\. { deny all; }), security headers (HSTS, X-Content-Type-Options, CSP in Report-Only), rate limiting (limit_req), fail2ban.
  5. Verify: Run the 13-item security checklist. Spot-check: curl -s https://<fqdn>/.env -w '%{http_code}\n' (expect 403/404), ss -tlnp (no app ports public).

Load references/public-web-deploy.md for the full 13-item checklist, nginx config blocks, and error handling.


B. Dev-Branch Deploy

Test Hermes or Maia stack changes in a live lab region before merging to master via Concourse dev lane.

  1. Preflight: Verify dev branch on both repos + pipeline wired.
  2. Merge feature into dev branch: git checkout <stack>-dev-branch && git merge --no-ff origin/<feature> && git push. Never force-push.
  3. Validate: Dev lane green. fly -t <target> watch -j <stack>/deploy-to-dev-<region>.
  4. Merge to master via PR after dev validation.

Load references/dev-branch-deploy.md for stack parameters, preflight commands, and pipeline regeneration.


C. Cron Automation

Static analysis of cron scripts against a 9-point reliability checklist. Read-only -- never execute scripts.

  1. DISCOVER: Locate scripts in scripts/*.sh, cron/*.sh, jobs/*.sh. Verify shell shebang.
  2. AUDIT: Run all 9 checks via regex (verify matches not in comments):
#CheckSeverityKey patterns
1Error handlingCRITICALset -e, set -o errexit
2Exit code checkingHIGH$?, if [ $? -eq
3Logging with timestampsHIGH>> *.log, $(date)
4Log rotationMEDIUMfind -mtime -delete, logrotate
5Working directoryHIGHcd "$(dirname", SCRIPT_DIR=
6PATH environmentMEDIUMPATH=, export PATH
7Lock file / concurrencyHIGH.lock, flock, .pid
8Cleanup on exitMEDIUMtrap ... EXIT
9Failure notificationLOWmail -s, curl *webhook
  1. REPORT: Per-script scores with paste-ready fixes for every FAIL/WARN. Aggregate summary for multi-script audits.

Load references/cron-automation.md for the best-practices reference script.


D. Headless Cron Creator

Create headless Claude Code cron jobs. All crontab mutations go through crontab-manager.py.

  1. PARSE: Extract name (kebab-case), prompt, schedule, workdir, budget ($2.00 default).
  2. GENERATE: python3 ~/.claude/scripts/crontab-manager.py generate-wrapper --name <name> .... Verify: flock, --permission-mode auto, --max-budget-usd, tee logging, dry-run default.
  3. VALIDATE: bash -n scripts/<name>-cron.sh. Run 9-point cron checklist.
  4. INSTALL: Dry-run first (--dry-run), ask user confirmation, then install.
  5. REPORT: Script path, schedule, log dir, budget, management commands.

Load references/headless-cron-creator.md for the full methodology and schedule conversion table.


E. Toolkit Install

  1. Run python3 ~/.claude/scripts/install-doctor.py check and python3 ~/.claude/scripts/toolkit-health.py --json.
  2. If issues: guide user to ./install.sh --symlink. Fix permissions and deps as needed.
  3. Show inventory: python3 ~/.claude/scripts/install-doctor.py inventory.
  4. Show MCP status: python3 ~/.claude/scripts/mcp-registry.py list.
  5. Orient: /do, /comprehensive-review, /install commands.

Load references/install.md for full diagnostic steps and error handling.


Show full SKILL.md (351 more words)Show less

F. Shell Configuration

Detect target shell first. Fish and Zsh have incompatible syntax.

ConceptFishZsh
Variable assignmentset -gx VAR valueexport VAR=value
PATH managementfish_add_pathtypeset -U path; path=(...)
Completionscompletions/ directorycompinit + fpath
Conditionalstest, not [[ ]][[ ]] preferred
Interactive guardstatus is-interactive[[ -o interactive ]]

Load the shell-specific reference matching the task:

TaskFishZsh
Full configreferences/fish-shell-config.mdreferences/zsh-shell-config.md
Migration from Bashreferences/fish-bash-migration.mdreferences/zsh-bash-migration.md
Variables, special varsreferences/fish-quick-reference.mdreferences/zsh-quick-reference.md
Error audit, failure modesreferences/fish-preferred-patterns.mdreferences/zsh-preferred-patterns.md
Dev tool integrationreferences/fish-tool-integrations.mdreferences/zsh-tool-integrations.md

G. Process Management

Match the need to the pattern:

GoalCommand
Background job, exits with shellcmd &
Survive shell exitnohup cmd > log 2>&1 &
Detach from job controlcmd & disown
Full detach, new sessionsetsid cmd > log 2>&1 < /dev/null &
System daemonsystemd unit file

All backgrounded processes must redirect stdio: > out 2>&1 < /dev/null &. Order matters: > out 2>&1 is correct; 2>&1 > out is almost always a bug.

Key rule: verify the observable state (port free, PID dead) after every kill -- do not assume kill succeeded.

Load deep references for specific tasks:

TaskReference
Process lifecycle patternsreferences/shell-process-patterns.md, references/starting-processes.md
PID capture and resolutionreferences/pid-resolution.md
Signal and trap disciplinereferences/signals-and-traps.md
Kill verification, stale PIDreferences/cleanup-verification.md
Shell gotchas (set -e, `

Deep References

All references below are >100 lines of domain-specific content. Load as directed by the sections above.

ReferenceLinesDomain
references/public-web-deploy.md259Full public deploy workflow + security checklist
references/dev-branch-deploy.md156Concourse dev-branch workflow
references/cron-automation.md1949-point cron audit checklist
references/headless-cron-creator.md150Headless cron job creation
references/install.md195Toolkit install and health check
references/shell-error-handling.md226Shell error handling patterns
references/concurrency-and-locks.md219Concurrency and locking
references/logging-and-rotation.md231Logging and rotation
references/starting-processes.md152Process start patterns
references/shell-process-patterns.md247Process lifecycle patterns
references/pid-resolution.md200PID capture and resolution
references/signals-and-traps.md259Signal and trap discipline
references/cleanup-verification.md253Kill-and-check verification
references/preferred-patterns.md354Shell gotchas and fixes
references/fish-shell-config.md247Fish shell configuration
references/fish-bash-migration.md149Bash-to-Fish migration
references/fish-quick-reference.md229Fish variable scope guide
references/fish-preferred-patterns.md240Fish failure modes
references/fish-tool-integrations.md318Fish dev tool patterns
references/zsh-shell-config.md310Zsh shell configuration
references/zsh-bash-migration.md248Bash-to-Zsh migration
references/zsh-quick-reference.md332Zsh parameter expansion
references/zsh-preferred-patterns.md290Zsh failure modes
references/zsh-tool-integrations.md368Zsh dev tool patterns

© notque, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 24 other files (references) in skills/infrastructure/deploy of notque/vexjoy-agent.

  • SKILL.md
  • references/cleanup-verification.md
  • references/concurrency-and-locks.md
  • references/cron-automation.md
  • references/dev-branch-deploy.md
  • references/fish-bash-migration.md
  • references/fish-preferred-patterns.md
  • references/fish-quick-reference.md
  • references/fish-shell-config.md
  • references/fish-tool-integrations.md
  • references/headless-cron-creator.md
  • references/install.md
  • references/logging-and-rotation.md
  • references/pid-resolution.md
  • references/preferred-patterns.md
  • references/public-web-deploy.md
  • references/shell-error-handling.md
  • references/shell-process-patterns.md
  • references/signals-and-traps.md
  • references/starting-processes.md
  • … and 5 more

Open the folder on GitHubat commit 5218674

Compare with similar skills

Deploy next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Deploy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deploy this skillnotque/vexjoy-agent438—~2.6kAutomated safety check: NotesMIT
Cronalytics8bit64k/cronalytics112—~4.7kAutomated safety check: PassMIT
Schedule Recipemohitagw15856/pm-claude-skills1.4k—~1.1kAutomated safety check: PassMIT
Wp Wpcli And Opsjorgerosal/wordpress-skills101—~326Automated safety check: PassMIT
Shadowvpn Deploy Clientmadeye/shadowvpn101—~2.4kAutomated safety check: NotesMIT
Gram Temporalspeakeasy-api/gram272—~2.6kAutomated safety check: PassAGPL-3.0

Similar skills

  • Cronalytics

    8bit64k/cronalytics

    Analyze, diagnose, and optimize Hermes cron jobs via the cronalytics CLI.

    112 GitHub stars~4.7k tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check passed
  • Schedule Recipe

    mohitagw15856/pm-claude-skills

    Turn 'run this every Friday at 4pm' into a working, copy-paste schedule on the user's actual runner.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Wp Wpcli And Ops

    jorgerosal/wordpress-skills

    WordPress WP-CLI and operations review for Codex. An agent skill from jorgerosal/wordpress-skills.

    101 GitHub stars~326 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Shadowvpn Deploy Client

    madeye/shadowvpn

    Deploy, install, and run the ShadowVPN client in a target environment — Linux (systemd), macOS (launchd), or Windows (Wintun, foreground launcher or scheduled-task service).

    101 GitHub stars~2.4k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check: notes
  • Gram Temporal

    speakeasy-api/gram

    A skill your agent uses when adding or changing background work in gram — a Temporal workflow, activity, schedule, signal, or ContinueAsNew loop; anything reacting to chat messages, tool calls, MCP…

    272 GitHub stars~2.6k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Hunting For Persistence Mechanisms In Windows

    mukul975/Anthropic-Cybersecurity-Skills

    Systematically hunts for adversary persistence mechanisms across Windows endpoints, covering registry Run/RunOnce keys, services, startup folders, scheduled tasks, and WMI event subscriptions.

    34k GitHub stars~1.2k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed

More from notque/vexjoy-agent

All 61 skills in this repo
  • Game Asset Generator

    notque/vexjoy-agent

    Deterministic palette/matrix pixel art (not AI). An agent skill from notque/vexjoy-agent.

    438 GitHub stars~2.3k tokensUpdated 5 days ago
    Auto-check: notes
  • PR Workflow

    notque/vexjoy-agent

    Pull request lifecycle: commit, codex review, sync, review, fix, status, cleanup, and PR mining.

    438 GitHub stars~2.8k tokensUpdated 5 days ago
    Auto-check: notes
  • Architecture Deepening

    notque/vexjoy-agent

    Improve architecture across modules by deepening interfaces.

    438 GitHub stars~3.3k tokensUpdated 5 days ago
    Auto-check: notes
  • Code Quality

    notque/vexjoy-agent

    Code quality: cleanup, linting, formatting, quality gates. An agent skill from notque/vexjoy-agent.

    438 GitHub stars~1.5k tokensUpdated 5 days ago
    Auto-check: notes
  • Codebase Analyzer

    notque/vexjoy-agent

    Statistical rule discovery from Go codebase patterns. An agent skill from notque/vexjoy-agent.

    438 GitHub stars~2k tokensUpdated 5 days ago
    Auto-check: notes
  • Comment Quality

    notque/vexjoy-agent

    Review and fix temporal references in code comments. An agent skill from notque/vexjoy-agent.

    438 GitHub stars~2k tokensUpdated 5 days ago
    Auto-check: notes

Works with

Questions about Deploy

What does Deploy do?

Deploy and infrastructure: web deploy, dev branches, cron, package install, shell configuration. Deploy is an agent skill from notque/vexjoy-agent. Deploy and infrastructure: web deploy, dev branches, cron, package install, shell configuration.

When should I use Deploy?

Deploy fits situations like: tasks that involve Scheduled and recurring tasks.

How do I install Deploy in Claude Code?

Run `npx skills add notque/vexjoy-agent --skill deploy -a claude-code`. Or copy the skill folder (skills/infrastructure/deploy in notque/vexjoy-agent) into .claude/skills/deploy in your project. Claude Code loads it when a task matches its description.

How do I install Deploy in Codex?

Run `npx skills add notque/vexjoy-agent --skill deploy -a codex`. Or copy the skill folder (skills/infrastructure/deploy in notque/vexjoy-agent) into .agents/skills/deploy in your project. Codex loads it when a task matches its description.

Can I use Deploy in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add notque/vexjoy-agent --skill deploy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/deploy, .gemini/skills/deploy, .github/skills/deploy and .opencode/skills/deploy in your project.

What does Deploy need to run?

Going by SKILL.md and its folder, Deploy needs the command-line tools its instructions call (python3, curl, git, fly and bash). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Write, Bash, Grep, Glob, Edit, Agent.

Does Deploy access the network?

SKILL.md contains no URLs. Its commands use curl and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Deploy safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Deploy use?

Deploy is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Deploy use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 51k tokens, read only when the agent opens those files.

What are the alternatives to Deploy?

Skills that share tags, products or a category with Deploy: Cronalytics (8bit64k/cronalytics, 112 stars), Schedule Recipe (mohitagw15856/pm-claude-skills, 1.4k stars), Wp Wpcli And Ops (jorgerosal/wordpress-skills, 101 stars) and Shadowvpn Deploy Client (madeye/shadowvpn, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deploy?

notque (a GitHub user) maintains it in notque/vexjoy-agent, which has 438 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on October 3, 2026.

Source: notque/vexjoy-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.