os-new-item

Create portfolio item records with slug generation and tracker updates.

4|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/simonconway1979/os-intelligence --skill os-new-item
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: os-new-item
Source: https://github.com/simonconway1979/os-intelligence/tree/main/.claude/skills/os-new-item
Command: npx skills add https://github.com/simonconway1979/os-intelligence --skill os-new-item

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

os-new-item eliminates the repetitive, error-prone setup work of creating new portfolio records (folders, templates, and tracker entries) in your OS-Intelligence workflow.

Core Features & Use Cases

  • Portfolio-aware item creation: Adds an item to any portfolio project by reading the portfolio configuration from CLAUDE.md and the item template.
  • Slug + folder scaffolding: Generates a kebab-case slug, copies the correct template folder into the right items folder, and ensures required subfolders exist.
  • Tracker and active session updates: Updates TRACKER.md with the new item (including stage handling) and sets .current-session so follow-on skills target the new item immediately.
  • Use Case: When you want to log a new job opportunity, idea, or reading entry, this skill creates the record structure and gets you ready to capture content without manually wiring folders and metadata.

Quick Start

Ask your AI assistant: add a new opportunity to my portfolio called Acme Corp Senior PM with a one-sentence summary and your first action.

Frequently Asked Questions about os-new-item

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

FAQPage Schema
How do I create a new portfolio item without manually setting up folders and metadata?

Creating a new portfolio item is handled by reading the portfolio's CLAUDE.md configuration, applying the correct template, and scaffolding the item folder with a kebab-case slug. This automates the repetitive setup of folder structures and tracker entries for new opportunities or ideas.

What is portfolio item scaffolding and how does slug generation work?

Portfolio item scaffolding creates the required folder structure by copying a template into the items directory. Slug generation converts the item name into a kebab-case format, prompts for user confirmation, and ensures all required subfolders exist before updating TRACKER.md.

How do I update TRACKER.md and set the active context when adding a new portfolio entry?

TRACKER.md is updated automatically with the new item record and proper stage handling during creation. The skill also updates the .current-session file, making the new portfolio entry the active context so follow-on workspace automation skills target it immediately.

Do I need an existing OS-Intelligence portfolio folder structure to use this item creation workflow?

Yes, this workspace automation requires an existing OS-Intelligence portfolio folder containing a CLAUDE.md configuration file. The skill reads this configuration to identify the target portfolio and apply the appropriate item templates during the creation flow.

Can I add different types of items like job opportunities and articles to my portfolio from an active session?

Yes, you can create new opportunities, ideas, articles, and other portfolio item types from within an active session or as a standalone selection flow. The skill applies the specific template configured for each item type in your portfolio workspace.

What is the best way to automate product workflow tracker updates when logging a new idea?

The best way to automate tracker updates is using a skill that reads portfolio configurations and inserts new records directly into TRACKER.md. This ensures stage handling is applied correctly and the active session context is updated without manual markdown editing.