forcedotcom/sf-skills / plugins/builder/dx-devops/skills/dx-devops-project-manage
dx-devops-project-manage
VerifiedUse to list, view, or manage DevOps Center projects in a Salesforce org — show all projects, create a project, or update an existing project's name, description, or active status. Invoke to run sf devops project list on any listing request, or to create a project, set up a new pipeline foundation, initialize DevOps Center for a feature, update project settings, or activate/deactivate (archive) a project. Consolidates sf devops project list/create/update. DO NOT TRIGGER for work item, pipeline, promotion, or conflict operations — those are separate skills.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.9 KB |
| examples/common-workflows.md | markdown | 5.6 KB |
| references/cli-commands.md | markdown | 7.2 KB |
| scripts/create-project.shexecutable | script | 2.1 KB |
| scripts/list-projects.shexecutable | script | 1.9 KB |
| scripts/update-project.shexecutable | script | 3.9 KB |
examples/common-workflows.md
View on GitHub# Common Project Management Workflows
Real-world examples of typical project operations in DevOps Center autonomous release scenarios.
---
## Workflow 1: List All Projects
**User request:** "Show me all DevOps Center projects in this org"
**Steps:**
1. **Verify authentication**:
```bash
sf org display --json
```
2. **List projects**:
```bash
sf devops project list --target-org my-devops-org --json
```
3. **Present in a readable format**:
```bash
sf devops project list --target-org my-devops-org --json | \
jq -r '.result.projects[] | "\(.Id): \(.Name) — \(.Description // "(no description)")"'
```
Output:
```text
1Qg000000000001: Project Alpha — Core platform release pipeline
1Qg000000000002: Project Beta — (no description)
```
---
## Workflow 2: Create a New Project (Entry Point for a Release)
**User request:** "Set up a new DevOps Center project called 'Release Q3' for our Q3 features"
**Steps:**
1. **Idempotent check** — confirm it doesn't already exist:
```bash
NAME="Release Q3"
EXISTING_ID=$(sf devops project list --target-org my-devops-org --json | \
jq -r ".result.projects[] | select(.Name == \"$NAME\") | .Id" | head -n1)
```
2. **Create only if not found**:
```bash
if [ -n "$EXISTING_ID" ]; then
echo "Project already exists: $EXISTING_ID"
else
# Create, then read the ID back from the authoritative list envelope
sf devops project create \
--target-org my-devops-org \
--name "$NAME" \
--description "Q3 feature release pipeline" \
--json >/dev/null
NEW_ID=$(sf devops project list --target-org my-devops-org --json | \
jq -r ".result.projects[] | select(.Name == \"$NAME\") | .Id" | head -n1)
echo "Created project: $NEW_ID"
fi
```
> In practice, use `scripts/create-project.sh "$NAME" "Q3 feature release pipeline"` — it performs this idempotent create-then-verify and prints `EXISTING <id>` or `CREATED <id>`.
3. **Hand off the project ID** to `dx-devops-work-item-manage` or `dx-devops-pipeline-manage` for the next steps.
---
## Workflow 3: Resolve a Project Name to Its ID
**User request:** "What's the project ID for Project Alpha?"
**Steps:**
1. **Filter the list by name**:
```bash
sf devops project list --target-org my-devops-org --json | \
jq -r '.result.projects[] | select(.Name == "Project Alpha") | .Id'
```
Output: `1Qg000000000001`
2. **Return the ID** so downstream skills (work items, pipelines) can use it.
---
## Workflow 4: Rename a Project
**User request:** "Rename 'Project Alpha' to 'Platform Core'"
Resolve the name to an ID, update it, then verify:
```bash
PROJECT_ID=$(sf devops project list --target-org my-devops-org --json | \
jq -r '.result.projects[] | select(.Name == "Project Alpha") | .Id')
sf devops project update \
--target-org my-devops-org \
--project-id "$PROJECT_ID" \
--name "Platform Core" \
--json
sf devops project list --target-org my-devops-org --json | \
jq -r ".result.projects[] | select(.Id == \"$PROJECT_ID\") | .Name" # -> Platform Core
```
---
## Workflow 5: Update Project Description
**User request:** "Update the description for project 1Qg000000000001 to note it now covers services too"
```bash
sf devops project update \
--target-org my-devops-org \
--project-id 1Qg000000000001 \
--description "Core platform + services release pipeline" \
--json
# Confirm from the authoritative list envelope
sf devops project list --target-org my-devops-org --json | \
jq -r '.result.projects[] | select(.Id == "1Qg000000000001") | .Description'
```
---
## Workflow 6: Update Multiple Fields at Once
**User request:** "Rename project 1Qg000000000002 to 'Beta Program' and update its description"
Pass every field in a single `update` call, then verify from the list envelope:
```bash
sf devops project update \
--target-org my-devops-org \
--project-id 1Qg000000000002 \
--name "Beta Program" \
--description "Early-access beta feature pipeline" \
--json
sf devops project list --target-org my-devops-org --json | \
jq -r '.result.projects[] | select(.Id == "1Qg000000000002") | "\(.Name) — \(.Description)"'
```
---
## Workflow 6b: Deactivate (Archive) a Project
**User request:** "Archive project 1Qg000000000002 — we're done with the beta"
**Steps:**
1. **Deactivate the project**:
```bash
sf devops project update \
--target-org my-devops-org \
--project-id 1Qg000000000002 \
--no-is-active \
--json
```
2. **Confirm** the project is inactive by re-reading the authoritative list envelope:
```bash
sf devops project list --target-org my-devops-org --json | \
jq -r '.result.projects[] | select(.Id == "1Qg000000000002") | .IsActive'
```
Output: `false`
> To reactivate later, run the same command with `--is-active` instead of `--no-is-active`.
---
## Workflow 7: Bootstrap — First Project in a Fresh Org
**User request:** "I just enabled DevOps Center. Get me started with a project."
**Steps:**
1. **Confirm the org has DevOps Center and list existing projects**:
```bash
sf devops project list --target-org my-devops-org --json | jq '.result.projects | length'
```
Output: `0` (empty — no projects yet)
2. **Create the first project**:
```bash
sf devops project create \
--target-org my-devops-org \
--name "Main Release Pipeline" \
--description "Primary continuous delivery project" \
--json
```
3. **Report the project ID** and guide the user to the next step:
> Project created (ID: `1Qg000000000010`). Next, create a pipeline with `dx-devops-pipeline-manage` and work items with `dx-devops-work-item-manage`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |