orbitant-os

Use when the user is done learning for the day, wants to save progress, or wants to wrap up a lesson. Also triggered by /learn when postponing or abandoning. Updates the learning intelligence layer (insights.md) after each session. Triggers on: "end session", "done learning", "save progress", "wrap up", "end-learn", "I'm done for today".

Use when the user wants to set up or update their learning profile, configure learning preferences, update their role or gaps, add feedback from reviews or 1:1s, or when any other learning skill detects no profile exists. Triggers on: "set up learning", "update my learning profile", "init learning", or pasting performance feedback.

Use when the user wants to sit down and learn, continue a lesson, practice a skill, or work through a learning project. Triggers on: "let's learn", "continue my lesson", "start learning", "practice", "I have time to learn", or "pick up where I left off".

Internal-only skill — never called directly by users. Provides the Learning Intelligence Layer. Two modes: "build context" (called by /learn at session start) reads learning history and produces a learner context; "update insights" (called by /end-learn after session close) updates the persistent insights.md summary.

Use when the user wants to review what they've learned, see progress on their gaps, get a summary of recent learning sessions, or wants article ideas based on learnings. Triggers on: "learning report", "what have I learned", "progress report", "summarize my learning", or "learning summary for the last month".

Use when the user wants a fast status check on their learning without a full report. Triggers on: "learning status", "where am I", "what's my learning state", "how's my learning going", or "check my progress".

Use when the user wants to find what to learn next, explore learning topics, get project ideas for a skill gap, or add a learning idea to their backlog. Triggers on: "what should I learn", "suggest learning projects", "I want to learn X", "add to my learning backlog", or "find me resources on X".

Content generation skill for the Orbitant engineering blog. Activates when creating a blog post in Spanish from raw input — a Knowledge Sharing transcript, Slack thread, meeting notes, workshop draft, or bullet outline. Produces a structured, SEO-optimised article that matches Orbitant's narrative, tone, and content cluster strategy. Trigger on: "crear blog post", "redactar artículo", "convierte esto en un post", "blog post para Orbitant", "write a blog post", "turn this into an article". Also trigger when the user shares a long transcript, KS notes, or a Slack discussion about a technical decision — even if they don't explicitly say "blog post". When in doubt, ask if they want this turned into a post.

Drafts structured, publication-ready release notes from git history. Activates when: creating releases, documenting version changes, drafting changelogs, or preparing release announcements. Use even when user just says "generate changelog", "what changed since last release", "help me write release notes", "prepare a release", or "I bumped the version". Also triggers after version bumps in plugin.json.

Scores items against quarterly rocks from rocks.yaml. Activates during triage, task ranking, meeting prep, and scheduling. Flags drift when time allocation mismatches stated priorities.

Checks MCP servers and config files before any chief-of-staff command. Ensures no command hard-fails — always proceeds with available sources. Auto-activates on every command.

Writes drafts in the user's voice using voice.md for tone and style. Activates during /triage, /crm, or any "draft an email/message" request. Never sends without confirmation.

Use at the end of a Claude Code session to capture project-specific friction as proposed CLAUDE.md edits. Triggered by /debrief (no args) to scan the full session, or /debrief <hint> to focus on a specific area (e.g., /debrief the API naming convention thing). Returning "session looks clean" with no proposals is a first-class outcome, not a fallback. Triggers on: "/debrief", "debrief the session", "wrap up this session", "what did we learn", "any rules to capture", "should we update CLAUDE.md".

Use when checking if a repo follows 12-factor app principles — config stored in env vars (not hardcoded), dependency lockfiles present, CI pipeline separation, structured logging to stdout, or dev/prod environment parity. Activates when someone asks about 12-factor compliance, deployment readiness, or config management practices in a Node.js or Python project. Also trigger when someone notices hardcoded localhost URLs, missing .env.example, or asks "is this deploy-ready?" — even without mentioning 12-factor explicitly.

Use when auditing whether a repo is configured for AI-assisted development — checking .claude/ setup quality, CLAUDE.md completeness, skills/agents presence, hooks, memory, or MCP server configuration. Activates when someone asks "is this repo AI-ready?", "how well is Claude configured here?", or wants to assess AI readiness before starting work on an unfamiliar project. Also trigger when reviewing any .claude/ config, CLAUDE.md quality, or hooks setup — even if the user doesn't explicitly mention "AI readiness".

Use when auditing git practices in a repo — Conventional Commits compliance, branch naming standards, secrets committed to history, direct commits to main, or stale branches. Activates when someone asks "is the git hygiene good here?", wants to check commit discipline, or needs to assess branch/release health before starting work on a project. Also trigger when someone asks "are my commits OK?", "is my branch name right?", or shares a git log — even if they don't explicitly mention "hygiene".

Use when scanning a Node.js or Python repo for OWASP Top 10 vulnerabilities — hardcoded secrets, SQL injection patterns, weak cryptography, dangerous functions (eval, exec, shell=True), missing security headers, or dependency lockfile issues. Activates when someone asks about security posture, wants a static security scan, or needs to assess risk before a code review or client engagement.

Drafts the monthly Orbitant newsletter from Slack links, Knowledge Sharing recaps, blog posts, and meetup updates. Activate when the user mentions "newsletter", "monthly email", "prepare the newsletter", "newsletter de [mes]", "borrador de newsletter", or provides materials for the monthly send (KS recap, Slack links, blog posts). Also triggers when asked to "draft the email for this month" or "prepare the MailerLite send". Curates Slack channel links autonomously, writes all copy in English, and outputs a complete Markdown draft ready for MailerLite layout.

Generates blog post thumbnail images for Orbitant following the brand's visual identity, using Google's Imagen API (Nano Banana 2). Activates when creating blog images, generating thumbnails, designing featured images for articles, or when someone needs a visual for an Orbitant insight/blog post. Use this skill even if the user just says "I need an image for this article", "create a thumbnail", "generate a hero image", or "make a featured image". Also triggers when the user mentions "Nano Banana 2", "image generation", or asks for a prompt for an AI image tool.

LinkedIn content planner for Orbitant. Takes a published blog post (markdown) and produces a full content plan with multiple LinkedIn pieces ready for scheduling: a standard post with link, a carousel structure proposal, and a multimedia asset recommendation (infographic or diagram). Each piece uses a different angle from the same source material. Output is ready for handoff to n8n or manual scheduling. Activate when user shares a blog post and asks for LinkedIn content, social media copy, a content plan, carousel proposals, or content repurposing for LinkedIn. Also trigger when asked to "turn this into LinkedIn posts", "create social media from this article", or "help me schedule this content" — even if they don't explicitly mention LinkedIn or social media strategy.

YouTube video description generator for Orbitant Knowledge Sharing (KS) sessions. Takes a session transcript (.vtt or plain text) and produces a bilingual, SEO-optimised YouTube description — Spanish first, then English — built around a positionable keyword. The description is structured to rank in YouTube and Google search: keyword in the first line, natural repetition in the overview and takeaways, and hashtags chosen for search intent, not just labels. Use this skill whenever someone needs to write or generate a YouTube description for a KS session or any Orbitant video — even if they just say "escribe la descripción del vídeo", "I need the YouTube copy", or "help me upload this session". Also trigger when given a transcript and asked to prepare anything for a video upload.

Editorial review skill for Orbitant engineering blog posts. Activates when reviewing, editing, or providing feedback on blog articles. Produces structured reviews covering SEO, content quality, tone, and actionable improvements. Responds in the same language as the article being reviewed. Use this skill whenever someone asks to review a blog post, wants editorial feedback on a draft, needs SEO analysis for an article, or requests writing improvements for the Orbitant blog — even if they don't explicitly mention "review".

Translation skill for validated Orbitant blog posts. Takes a Spanish article that has already been reviewed and approved by a human editor, and produces an English version optimised for English-speaking audiences. Keyword selection is not a literal translation but a search-intent-driven choice for the English market. Use this skill only on articles that have completed the full editorial and review process.

Voice and tone reference for Orbitant blog content. Defines what Orbitant writing sounds like, what it values, and what it avoids — with concrete examples. Activate when user asks about Orbitant voice, tone, writing style, brand voice, or editorial guidelines. Also trigger when reviewing blog content for consistency, checking if text "sounds like Orbitant", or when creating/editing marketing content — even if they don't explicitly mention tone or voice.

Reviews SKILL.md files for quality and compliance with orbitant-os conventions. Use when: reviewing a skill, checking skill quality, validating skill format, or when asked to "review this skill" or "check if this skill is good". Also activates for CI skill validation requests.