skills.rest
microsoft
microsoftOFFICIAL
Explore all skills by this author →
Website𝕏@OpenAtMicrosoftGitHub

self-managing-tool-patterns

Design self-managing lifecycle patterns for CLI tools and services on Linux and macOS.

10|11|Updated Feb 22, 2026
Search Tags:#cli#service management#systemd#launchd#upgrade workflow#doctor command#pep 610
One-click install
npx skills add https://github.com/microsoft/amplifier-bundle-skills --skill self-managing-tool-patterns
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: self-managing-tool-patterns
Source: https://github.com/microsoft/amplifier-bundle-skills/tree/main/skills/self-managing-tool-patterns
Command: npx skills add https://github.com/microsoft/amplifier-bundle-skills --skill self-managing-tool-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you turn a long-lived CLI or service into something users can inspect, install as a background service, upgrade safely, and verify after changes without manual server access.

Core Features & Use Cases

  • Doctor Command Design: Create a structured health check that reports versions, dependencies, service status, settings, TLS, and authentication readiness.
  • Cross-Platform Service Management: Generate and manage systemd user units on Linux and launchd agents on macOS while preserving PATH for external tools.
  • Safe Upgrade Flow: Implement a stop, reinstall, regenerate, restart, and verify sequence that works for packaged, git-based, and editable installs.
  • Install Source Detection: Use PEP 610 metadata to determine whether an upgrade should come from PyPI, a git remote, or be skipped for editable installs.

Quick Start

Ask for a production-ready self-management pattern for your CLI tool, including doctor diagnostics, service install and uninstall, and a safe upgrade flow for Linux and macOS.

Frequently Asked Questions about self-managing-tool-patterns

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

FAQPage Schema
How do I build a CLI tool doctor command for diagnostics and health checks?▼

A doctor command for CLI tools reports versions, dependencies, service status, settings, TLS, and authentication readiness to verify system health. It provides structured diagnostics so users can inspect issues without manual server access.

What is the best way to install a Python CLI as a background service on Linux and macOS?▼

Installing a CLI as a background service requires generating systemd user units on Linux and launchd agents on macOS. You must preserve PATH for external tools so the long-running service can locate dependencies and execute correctly.

How do I safely upgrade a running CLI service without breaking dependencies?▼

A safe CLI service upgrade uses a stop, reinstall, regenerate, restart, and verify sequence. This upgrade flow prevents runtime errors by ensuring the old service stops completely before applying changes and restarting with verification.

How does PEP 610 install-source detection work for CLI upgrades?▼

PEP 610 install-source detection reads metadata to determine whether a CLI was installed from PyPI, a git remote, or as an editable install. This dictates whether an upgrade pulls from PyPI, fetches from git, or skips entirely.

Can I use systemd and launchd service management for editable Python installs?▼

systemd and launchd service management supports editable installs by generating platform-specific service units. However, the safe upgrade flow skips automated reinstalling for editable installs to prevent overwriting local development changes.

Related Skills

Explore More Software Engineering Skills→
zhu637882-stackzhu637882-stack

env-setup

Detect, install, and configure Homebrew, Node.js, pnpm, PostgreSQL, Redis, Git, then output a summary.

Community
Advanced
ondrej-svecondrej-svec
18

share-server-control

Manage local share server lifecycle via LaunchAgent scripts and health checks.

Community
Intermediate
samlaggzsamlaggz

independent-background-agents

Run Hermes background tasks with systemd-run units and stable log paths.

Community
Advanced
capawesome-teamcapawesome-team
37

capawesome-cli

Manage Capawesome CLI authentication, project linking, and command workflows.

Official
Advanced