skill-deployment

Automate zero-downtime PHP deployments to VPS and shared hosting.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/claudioborja/biblioteca --skill skill-deployment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-deployment
Source: https://github.com/claudioborja/biblioteca/tree/main/.agents/skills/skill-deployment
Command: npx skills add https://github.com/claudioborja/biblioteca --skill skill-deployment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deploying PHP apps across diverse hosting environments (VPS with full control and shared hosting with limited access) is error-prone and time-consuming. This Skill provides a repeatable, zero-downtime workflow that minimizes outages during releases.

Core Features & Use Cases

  • Atomic deployments with symlinks to guarantee no mid-deploy downtime.
  • Environment handling via .env on VPS or a config fallback on restricted hosts.
  • Automated migrations, permission management, and post-deploy checks.
  • SSL setup, OPcache configuration, firewall hardening, cron job integration, and rollback support.

Quick Start

Run the zero-downtime deploy script after validating the environment to publish a new release.

Frequently Asked Questions about skill-deployment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a PHP application with zero downtime on a VPS?

Zero-downtime PHP deployment on a VPS uses atomic symlink deployments. This approach switches a symlink to a new release directory, ensuring no mid-deploy downtime, and includes automated migrations, permissions management, and OPcache handling.

Can I run automated PHP migrations and SSL setup on shared hosting?

Yes, automated PHP migrations and SSL setup are supported on shared hosting environments like cPanel, Plesk, and DirectAdmin. The process uses a config fallback for environment handling when .env files are restricted by the limited hosting access.

What is atomic symlink deployment and how does it prevent outages?

Atomic symlink deployment is a release strategy where a new application version is built in a separate directory. By atomically updating a single symlink to point to the new release, it guarantees no mid-deploy downtime or outages during the switch.

How do I rollback a PHP release if a deployment fails?

To rollback a failed PHP release, the deployment workflow includes rollback strategies that revert the atomic symlink back to the previous stable release directory. This ensures immediate recovery and safe, repeatable releases.

Does this PHP deployment workflow include production hardening and firewall rules?

Yes, the PHP deployment workflow includes production hardening features. It applies firewall rules, OPcache configuration, SSL setup, and cron job integration to ensure the server environment is secure and the release is safe.