https://github.com/render-oss/skills
Render Agent Skills
https://github.com/render-oss/skills
Last synced: about 1 month ago
JSON representation
Render Agent Skills
- Host: GitHub
- URL: https://github.com/render-oss/skills
- Owner: render-oss
- License: mit
- Created: 2026-01-27T00:18:53.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-18T18:15:30.000Z (2 months ago)
- Last Synced: 2026-03-19T07:46:41.930Z (2 months ago)
- Language: Shell
- Size: 249 KB
- Stars: 21
- Watchers: 0
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Render Skills for AI Agents
Skills to deploy, debug, and monitor Render services.
## Table of Contents
- [Compatibility](#compatibility)
- [Installation](#installation)
- [Skills](#skills)
- [render-deploy](#render-deploy)
- [render-debug](#render-debug)
- [render-monitor](#render-monitor)
- [render-migrate-from-heroku](#render-migrate-from-heroku)
- [render-workflows](#render-workflows)
- [Auto-Approval Hooks](#auto-approval-hooks)
- [Prerequisites](#prerequisites)
- [Quick Start](#quick-start)
- [Contributing](#contributing)
- [Repository Structure](#repository-structure)
- [Support](#support)
- [License](#license)
## Compatibility
| Feature | Claude Code | Codex | OpenCode | Cursor |
|---------|-------------|-------|----------|--------|
| Skill prompts (SKILL.md) | ✅ | ✅ | ✅ | ✅ |
| Render CLI commands | ✅ | ✅ | ✅ | ✅ |
| Render MCP tools | ✅ | ✅ | ✅ | ✅ |
| Auto-approval hooks | ✅ | ❌ | ❌ | ❌ |
## Installation
### Quick Install (Recommended)
Install to all detected tools:
```bash
curl -fsSL https://raw.githubusercontent.com/render-oss/skills/main/scripts/install.sh | bash
```
Targets: Claude Code, Codex, OpenCode, and Cursor.
### Claude Code
```bash
/plugin marketplace add render-oss/skills
/plugin install render@skills
```
### OpenAI Codex
```bash
$skill-installer render-deploy
$skill-installer render-debug
$skill-installer render-monitor
$skill-installer render-migrate-from-heroku
$skill-installer render-workflows
```
### Manual Installation
Copy each skill directory from `skills/` into your tool's skills directory:
- **Claude Code (skills mode):** `~/.claude/skills//`
- **Codex:** `~/.codex/skills//`
- **OpenCode:** `~/.config/opencode/skills//`
- **Cursor:** `~/.cursor/skills//`
Example (Codex):
```bash
cp -R skills/render-deploy ~/.codex/skills/render-deploy
cp -R skills/render-debug ~/.codex/skills/render-debug
cp -R skills/render-monitor ~/.codex/skills/render-monitor
cp -R skills/render-migrate-from-heroku ~/.codex/skills/render-migrate-from-heroku
cp -R skills/render-workflows ~/.codex/skills/render-workflows
```
---
## Skills
### render-deploy
Deploy via Blueprint (`render.yaml`) or direct MCP creation.
- Detects common stacks and configures build/start
- Creates services, cron jobs, and databases via MCP
- Verifies deploys with basic health/metrics checks
[Full Documentation](skills/render-deploy/SKILL.md)
### render-debug
Find root causes using logs, metrics, and (when needed) database queries.
- Structured log queries via MCP
- CPU/memory/latency diagnostics
- Fix suggestions for common deploy failures
[Full Documentation](skills/render-debug/SKILL.md)
### render-monitor
Check service health, performance metrics, and recent logs.
- Health checks and deploy status
- CPU/memory/latency/bandwidth
- Log filtering and summaries
[Full Documentation](skills/render-monitor/SKILL.md)
### render-migrate-from-heroku
Migrate Heroku apps to Render by reading local project files and generating equivalent Render services.
- Reads Procfile, dependency files, and app config to determine runtime and commands
- Generates Blueprint YAML or creates services via Render MCP
- Optionally uses Heroku MCP to enrich with live config vars and add-on details
- Generates database migration commands and verifies deployment health
[Full Documentation](skills/render-migrate-from-heroku/SKILL.md)
### render-workflows
Set up, develop, test, and deploy Render Workflows.
- Scaffolds a `workflows/` directory via CLI or manual setup (Python and TypeScript)
- Guides task configuration with retries, subtasks, and fan-out patterns
- Local development with `render workflows dev`
- Deploys workflow services via Dashboard
- Constraints, pricing, and troubleshooting reference
[Full Documentation](skills/render-workflows/SKILL.md)
---
## Auto-Approval Hooks
Auto-approves safe, read-only CLI operations:
- **Listing services**: `render services list`, `render services -o json`
- **Reading logs**: `render logs -r`, `render logs --raw`
- **Checking workspaces**: `render workspace current`, `render workspace list`
Operations that modify infrastructure still require permission:
- Deployments (`render deploy`)
- Service restarts (`render services restart`)
- Service creation/deletion (`render services create`, `render services delete`)
- Configuration changes (`render services update`)
- Workspace changes (`render workspace set`)
---
## Prerequisites
- Render MCP tools configured with an API key
- `RENDER_API_KEY` environment variable
- Git repository pushed to GitHub, GitLab, or Bitbucket (for deploys)
- Optional: Render CLI for streaming logs/SSH
## Quick Start
Deploy: "Deploy my application to Render"
Debug: "Debug my Render deployment"
Monitor: "Is my Render service healthy?"
Migrate: "Migrate my Heroku app to Render"
Workflows: "Set up Render Workflows in my project"
Add tasks: "Add a new workflow task with retries"
---
## Contributing
### Adding a New Skill
1. Create `skills/your-skill-name/` with `SKILL.md` (optional `references/`, `assets/`).
2. Add frontmatter in `SKILL.md`:
```yaml
---
name: your-skill-name
description: Brief description
license: MIT
compatibility: Prerequisites and requirements
metadata:
author: Render
version: "1.0.0"
category: category-name
---
```
3. Keep `SKILL.md` concise; move details to `references/`.
4. Test locally:
```bash
claude plugin add /path/to/skills
```
Examples: [deploy](skills/render-deploy/), [debug](skills/render-debug/), [monitor](skills/render-monitor/), [render-migrate-from-heroku](skills/render-migrate-from-heroku/), [workflows](skills/render-workflows/).
---
## Repository Structure
```
render-skill/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Marketplace metadata
├── skills/
│ ├── render-deploy/ # Deployment skill
│ ├── render-debug/ # Debugging skill
│ ├── render-monitor/ # Monitoring skill
│ ├── render-migrate-from-heroku/ # Heroku migration skill
│ └── render-workflows/ # Workflows setup, development, and deployment
├── hooks/
│ ├── hooks.json # Hook configuration
│ └── auto-approve-render.sh # Auto-approval script
├── scripts/
│ └── install.sh # Multi-tool installer
├── .mcp.json # MCP server configuration
├── README.md # This file
├── .gitignore
└── LICENSE
```
---
## Support
- **Documentation:** https://render.com/docs
- **Issues:** https://github.com/render-oss/skills/issues
- **Render Support:** support@render.com
---
## License
MIT License - see [LICENSE](LICENSE) file for details.