feat(skills): add FocusAlignment skill to Telos category#876
feat(skills): add FocusAlignment skill to Telos category#876larsboes wants to merge 2 commits intodanielmiessler:mainfrom
Conversation
There was a problem hiding this comment.
Pull request overview
This PR adds a new FocusAlignment sub-skill to the Telos skill category. It provides TELOS-powered goal alignment checking by dynamically reading a user's GOALS.md, MISSION.md, PROJECTS.md, and CHALLENGES.md files at runtime — rather than using hardcoded focus areas. The skill exposes four workflows for different alignment scenarios.
Changes:
- Adds
FocusAlignment/SKILL.mdwith YAML frontmatter, voice notification, context detection, workflow routing, and examples. - Adds four workflow files:
AlignmentCheck.md,NeglectScan.md,BalanceAssessment.md, andDecisionFilter.md. - Updates
Telos/SKILL.mdto include FocusAlignment in the parent skill's routing table and description triggers.
Reviewed changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
Telos/SKILL.md |
Adds FocusAlignment entry to the routing table and appends its trigger keywords to the description |
FocusAlignment/SKILL.md |
Main sub-skill file with routing, examples, principles, and integration notes |
FocusAlignment/Workflows/AlignmentCheck.md |
Checks a new proposal against TELOS goals |
FocusAlignment/Workflows/NeglectScan.md |
Scans all TELOS goal areas for neglected ones |
FocusAlignment/Workflows/BalanceAssessment.md |
Rates investment across all goal categories |
FocusAlignment/Workflows/DecisionFilter.md |
Filters a decision through TELOS priorities |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| 4. **Recommend next steps:** | ||
| - Rank neglected areas by importance (from MISSION.md context) | ||
| - Suggest one small action per neglected area |
There was a problem hiding this comment.
The NeglectScan.md workflow's step 4 instructs the model to "Rank neglected areas by importance (from MISSION.md context)", but MISSION.md is never loaded in step 1 (which only loads GOALS.md, PROJECTS.md, and CHALLENGES.md). Without reading MISSION.md, there is no mission context available to rank by importance. Either add Read ~/.claude/PAI/USER/TELOS/MISSION.md to step 1's file-loading list (following the pattern in BalanceAssessment.md line 11 which does load it), or remove the MISSION.md reference from step 4.
|
|
||
| | Workflow | Purpose | Input | Output | | ||
| |----------|---------|-------|--------| | ||
| | **AlignmentCheck** | Verify proposal against TELOS goals | New project/commitment | Alignment score + honest assessment | |
There was a problem hiding this comment.
The Quick Reference table in FocusAlignment/SKILL.md describes the AlignmentCheck output as "Alignment score + honest assessment", but the actual AlignmentCheck.md workflow output template contains no score field — only PROPOSAL, SERVES, COSTS, CONFLICTS, and ASSESSMENT. Either add a score field (e.g. SCORE: [alignment score 1-5]) to the output template in AlignmentCheck.md, or update the Quick Reference description to accurately reflect the actual output format.
| | **AlignmentCheck** | Verify proposal against TELOS goals | New project/commitment | Alignment score + honest assessment | | |
| | **AlignmentCheck** | Verify proposal against TELOS goals | New project/commitment | Honest alignment assessment | |
|
|
||
| **Works well with:** | ||
| - **Telos** — Reads all TELOS context files for goal discovery | ||
| - **BrainDump** — When dumps touch goals/direction, BrainDump suggests running alignment check |
There was a problem hiding this comment.
The Integration section references BrainDump as a skill that "Works well with" FocusAlignment. However, no BrainDump skill exists anywhere in the repository (Releases/v4.0.3/.claude/skills/). This reference is dangling and could confuse users or the AI model. Either remove this integration entry, or ensure the BrainDump skill is created and included in this PR.
| - **BrainDump** — When dumps touch goals/direction, BrainDump suggests running alignment check |
Port TELOS-powered goal alignment checking as a PAI skill with 4 workflows: - AlignmentCheck: Verify new proposals against TELOS goals - NeglectScan: Find neglected goal areas - BalanceAssessment: Rate investment across goal areas - DecisionFilter: Filter decisions through TELOS priorities Key design: reads GOALS.md, MISSION.md, PROJECTS.md dynamically instead of hardcoding focus areas — every user's goals are different. Co-Authored-By: Claude Opus 4.6 <[email protected]>
Co-Authored-By: Claude Opus 4.6 <[email protected]>
larsboes
force-pushed
the
feat/focusalignment-skill
branch
from
5fd4371 to
4c92611
Compare
Summary
Adds a FocusAlignment skill to the Telos category — checks proposals, decisions, and life balance against TELOS goals.
Key design decision: the original version hardcoded 5 focus areas. This PAI version reads GOALS.md, MISSION.md, PROJECTS.md, and CHALLENGES.md dynamically at runtime — every user's priorities are different, so the skill discovers them instead of assuming them.
Four workflows:
Changes
Added:
skills/Telos/FocusAlignment/SKILL.md+ 4 workflows inWorkflows/Modified:
skills/Telos/SKILL.md— routing entry + trigger wordsStructure mirrors Council (frontmatter, customization check, voice notification, routing table).
Ported from a personal Claude Code skill system. The dynamic TELOS reading is new for the PAI version.
🤖 Generated with Claude Code