opportunity-update

Update job opportunity records in opportunities.yaml with stage and history changes.

4|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/ferez96/career-path-2026 --skill opportunity-update
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opportunity-update
Source: https://github.com/ferez96/career-path-2026/tree/main/docs/skills/opportunity-update
Command: npx skills add https://github.com/ferez96/career-path-2026 --skill opportunity-update

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It removes the need to manually edit your opportunity pipeline by safely applying precise stage, note, action, and closing updates to the correct record.

Core Features & Use Cases

  • Opportunity record updates: Update an opportunity’s stage, next actions, close outcome, and history by id (or by resolving company+role to an id first).
  • Schema-guided, low-risk edits: Uses python scripts/opp.py for scalar field changes and restricts direct YAML edits to only contacts[] and links (with merge semantics).
  • Verification after changes: Confirms the result by fetching the updated record with python scripts/opp.py get <id> and performs a sanity check for unusual transitions.

Quick Start

Tell me the opportunity id and exactly what changed (stage, next_action, notes, close outcome), and I will apply the update to data/opportunities.yaml and show the resulting record.

Frequently Asked Questions about opportunity-update

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

FAQPage Schema
How do I update a job opportunity stage and next actions in a YAML pipeline tracker?

You can update a job opportunity stage by providing the opportunity id and the changes to the YAML pipeline tracker. The Skill applies stage, next actions, and close outcomes to the specific record using a Python CLI.

What is the safest way to modify job opportunity records in a YAML file without breaking the schema?

The safest way to modify opportunity records is using the Python CLI script for scalar field changes, restricting direct YAML edits to only contacts and links merges. This schema-guided approach prevents data corruption.

Can I update an opportunity record in YAML if I only know the company and role but not the id?

Yes, you can resolve the opportunity id by providing the company and role. The Skill first resolves the company and role combination to the correct id before applying the stage or action updates to the YAML record.

How do I verify opportunity pipeline changes after updating the YAML file?

You verify opportunity pipeline changes by fetching the updated record using the Python CLI get command. This fetches the final state and performs a sanity check for unusual stage transitions.

What should I limit direct YAML edits to when tracking job search opportunities?

Direct YAML edits should be limited to only contacts array and links merges. All other scalar field updates like stage, notes, and close outcomes must go through the Python CLI to ensure safe opportunity tracking.