learn-skills

abdullahbeam's avatarfrom abdullahbeam

Learn how Nexus skills work. Load when user mentions: learn skills, how do skills work, what is a skill, skill tutorial, skill structure, understand skills, explain skills, when to create skill, skill vs project. 10-12 min.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025
[Tutoring and Explanations]

When & Why to Use This Skill

This Claude skill provides a comprehensive onboarding tutorial for the Nexus framework, designed to help users master the creation and management of AI skills. It introduces a structured 3-criteria framework—Frequency, Repeatability, and Value—to help users identify which manual workflows are 'skill-worthy' for automation. By explaining the technical structure and proactive triggering mechanisms, it empowers users to transform repetitive tasks into efficient, reusable AI-driven processes.

Use Cases

  • New User Onboarding: Guiding users through their first interaction with the Nexus system to understand core concepts.
  • Workflow Auditing: Helping users evaluate their weekly tasks to identify candidates for automation and time-saving.
  • Skill Development Education: Teaching the specific file architecture (SKILL.md, scripts, and assets) needed to build custom agent capabilities.
  • Trigger Optimization: Explaining how to write effective skill descriptions that allow the AI to proactively suggest the right tool at the right time.
namelearn-skills
description"Learn how Nexus skills work. Load when user mentions: learn skills, how do skills work, what is a skill, skill tutorial, skill structure, understand skills, explain skills, when to create skill, skill vs project. 10-12 min."
onboardingtrue
priorityhigh

🎯 AI Proactive Triggering (ONBOARDING SKILL)

This is an ONBOARDING skill with HIGH PRIORITY for proactive suggestion.

When to Proactively Suggest (AI MUST check user-config.yaml)

Check learning_tracker.completed.learn_skills in user-config.yaml. If false:

PROACTIVELY SUGGEST when user:

  1. Says "create skill" for the FIRST TIME (suggest learning before creating)
  2. Describes repeating work patterns ("every week I...", "I always have to...")
  3. Asks about automating workflows or creating templates
  4. Expresses confusion about what makes something a "skill"
  5. Creates multiple similar things (report-jan, report-feb anti-pattern)
  6. At the END of learn-projects (natural progression)
  7. When user completes a workflow that could be skill-worthy

Suggestion Pattern:

💡 I notice you're describing repeating work. Before creating a skill, would you
like a 10-minute tutorial on what makes workflows "skill-worthy"? It covers:
- The 3-criteria skill-worthiness framework
- How skills are structured
- How AI triggers skills automatically

Say 'learn skills' to start, or continue with your current task.

Anti-Pattern Detection:

If user creates: report-jan, report-feb, report-mar...
→ "I notice you're creating similar items. This is a perfect use case for
   a SKILL instead of multiple projects. Want to 'learn skills' to understand
   how to capture this as a reusable workflow?"

DO NOT suggest if:

  • learning_tracker.completed.learn_skills: true
  • User explicitly says "skip" or "just create the skill"
  • User has already created skills successfully

Learn Skills

Teach how to identify skill-worthy workflows and create effective skills.

Purpose

Help user understand what makes something skill-worthy, how skills are structured, and how skill triggering works. Includes hands-on practice identifying their own workflows.

Time Estimate: 10-12 minutes

Workflow

Step 1: Concrete Examples

✅ SKILLS (repeating workflows):
- Weekly status report (same format weekly)
- Qualify sales lead (same questions each time)
- Process expense reports (same steps)

❌ NOT SKILLS (one-time):
- Research competitor Acme (one-time)
- Build Q1 marketing plan (one-time)

Key question: Will I do this AGAIN?

Step 2: Skill-Worthiness Framework

Three questions:

1. FREQUENCY: 2+ times per month?
   YES → keep evaluating

2. REPEATABILITY: Steps mostly the same?
   YES → keep evaluating

3. VALUE: Saves >5 minutes per execution?
   YES → Create a skill!

ALL 3 YES = Skill-worthy
ANY NO = Just do it manually

Step 3: Skill Structure

📁 weekly-status-report/
├── SKILL.md       # Instructions + triggers
├── references/    # Documentation (optional)
├── scripts/       # Automation (optional)
└── assets/        # Templates (optional)

Step 4: How Triggering Works

AI checks your message against ALL skill descriptions.
Match found = skill loads.

Example description:
"Load when user says 'status report', 'weekly update',
 'progress summary'"

ANY of these triggers it:
• "Generate my status report"
• "Weekly update please"
• "Progress summary"

Step 5: Practice

Ask: "What did you do last week that you'll probably do again?"

For each: apply 3-criteria framework, brainstorm trigger phrases.

Step 6: How to Create

To create a skill, say:
• "create skill for [workflow]"
• "new skill: [name]"

YOUR skills go in 03-skills/ (prioritized!)
SYSTEM skills in 00-system/skills/

Step 7: Finalize

Actions (MUST complete all):

  1. Mark skill complete in user-config.yaml:

    learning_tracker:
  completed:
    learn_skills: true  # ADD THIS LINE

  2. Display completion:

    ✅ Learn Skills Complete!

You now understand:
• Skills = reusable workflows (do AGAIN → skill)
• 3-criteria framework (Frequency + Repeatability + Value)
• Skill structure (SKILL.md + optional references/scripts)
• Trigger mechanism (keywords in description)

Next steps:
• 'create skill' - Create your first skill
• 'learn projects' - Learn about temporal work
• 'learn nexus' - System mastery

  3. Prompt close-session:

    💡 When you're done working, say "done" to save progress.

Success Criteria

  • User understands skill vs project distinction
  • User can apply 3-criteria skill-worthiness framework
  • User knows skill folder structure
  • User understands trigger mechanism
  • User identified at least one potential skill from their work
  • learning_tracker.completed.learn_skills: true in user-config.yaml