# rsconnect-skill Agent skill for Posit Connect deployment workflows — **R and Python**. Handles Git-backed deployment, manifest management, renv lockfile issues, Source:unknown errors, R version upgrades, pre-commit validation, Python/uv deployments, FastAPI/Flask/Dash/Streamlit apps, and requirements.txt management. ## Supported Agents | Agent | Install Method | Status | |-------|---------------|--------| | [Cursor](https://cursor.com) | `npx skills add` | Fully supported | | [Claude Code](https://claude.ai) | `npx skills add` | Fully supported | | [Codex](https://openai.com/codex) | `npx skills add` | Fully supported | | [Copilot](https://github.com/features/copilot) | Manual install | Fully supported | | Any agent supporting [agentskills.io](https://agentskills.io) | `npx skills add` | Fully supported | ## Install ```bash # Via skills CLI (recommended — auto-detects your agent) npx skills add clssck/rsconnect-skill # Install to a specific agent npx skills add clssck/rsconnect-skill -a cursor npx skills add clssck/rsconnect-skill -a claude-code npx skills add clssck/rsconnect-skill -a codex ``` ## Update ```bash # Check for available updates npx skills check # Update to latest version npx skills update ``` ### Manual Installation Copy the skill into your agent's skills directory: ```bash # Cursor cp -r skills/rsconnect/ /path/to/your-project/.cursor/skills/rsconnect/ # Claude Code cp -r skills/rsconnect/ /path/to/your-project/.claude/skills/rsconnect/ # Copilot (or any agent using .github/) cp -r skills/rsconnect/ /path/to/your-project/.github/skills/rsconnect/ # Generic — adapt the path to your agent's convention cp -r skills/rsconnect/ /path/to/your-project//rsconnect/ ``` ```powershell # PowerShell (Windows) # Cursor Copy-Item -Recurse -Force skills/rsconnect/ C:\path\to\your-project\.cursor\skills\rsconnect\ # Claude Code Copy-Item -Recurse -Force skills/rsconnect/ C:\path\to\your-project\.claude\skills\rsconnect\ # Copilot (or any agent using .github/) Copy-Item -Recurse -Force skills/rsconnect/ C:\path\to\your-project\.github\skills\rsconnect\ # Generic — adapt the path to your agent's convention Copy-Item -Recurse -Force skills/rsconnect/ C:\path\to\your-project\\rsconnect\ ``` After installation, your project should have: ``` your-project/ / rsconnect/ SKILL.md scripts/ references/ ``` Where `` is your agent's skills directory (e.g., `.cursor/skills/`, `.claude/skills/`, `.github/skills/`, etc.). ## What's Included ### Skill (SKILL.md) Provides the agent with: - Language detection (R vs Python) as first triage step - Dynamic project status (versions, manifest status, dependency health) - Deployment method guidance (Git-backed, IDE, CLI, Jupyter, command line) - Common workflow recipes (deploy, fix errors, rollback, version upgrade) - Branch strategy recommendations (deploy branch, multi-environment) ### Helper Scripts — R | Script | Purpose | Flags | |--------|---------|-------| | `pre_deploy_check.R` | Validate deployment readiness (5 checks) | | | `diagnose.R` | Full diagnostics report | `--verbose`, `--help` | | `fix_unknown_sources.R` | Fix Source:unknown packages safely | `--dry-run`, `--help` | | `regenerate_manifest.R` | Regenerate manifest.json | | | `precommit_check.R` | Git pre-commit hook validation | | R scripts share a common utility library (`scripts/lib/parse_utils.R`) for consistent output formatting and renv.lock parsing. ### Helper Scripts — Python | Script | Purpose | Flags | |--------|---------|-------| | `pre_deploy_check_py.py` | Validate Python deployment readiness (7 checks) | | | `diagnose_py.py` | Full Python diagnostics report | `--verbose`, `--help` | | `regenerate_manifest_py.py` | Regenerate manifest for Python apps | `--type`, `--no-uv-export`, `--no-allow-uv` | Python scripts share a common utility library (`scripts/lib/py_utils.py`) for consistent output formatting and manifest parsing. They use only Python stdlib — no pip install needed. Scripts auto-detect their install location at runtime — no hardcoded paths. ```bash # R scripts — run from project root (replace $SKILL_DIR with your actual skill path) Rscript $SKILL_DIR/scripts/