phxagents / Skills / /phx:intro
skill effort: low

/phx:intro

Walk through the Elixir/Phoenix plugin commands, workflow, and features in 6 interactive sections. Use when a new user wants to learn what the plugin offers or needs a refresher on available commands.

Synopsis

/phx:intro [--section N]

Claude Code includes the full custom-agent and hook layer. Generated runtimes load the same skill knowledge with runtime-native invocation.

On this page
  1. Arguments
  2. Execution Flow
  3. Section Presentation Loop
  4. Section Titles
  5. Iron Laws
  6. Closing Message
  7. Notes

Plugin Introduction Tutorial

Interactive walkthrough of the Elixir/Phoenix plugin in 6 sections (~5 min).

Arguments

  • $ARGUMENTS may contain --section N to jump to a specific section (1-6)
  • No arguments = start from Section 1

Execution Flow

  1. Read ${CLAUDE_SKILL_DIR}/references/tutorial-content.md for all section content
  2. Parse $ARGUMENTS for --section N flag (1-6)
  3. If --section N specified, jump directly to that section
  4. Otherwise start from Section 1

Section Presentation Loop

For each section:

  1. Present the section content completely — do NOT abbreviate or summarize. Every paragraph, table, and code block in the reference file must appear in output — as visible response text emitted BEFORE the AskUserQuestion call; content composed only in thinking is invisible to the user
  2. After presenting, use AskUserQuestion with options:
    • If sections remain: “Next: [next section title]”, “Skip to Cheat Sheet”, “Stop here”
    • If on final section (6): no question needed, end with closing message

Section Titles

NTitle
1Welcome
2Core Workflow Commands
3Knowledge & Safety Net
4Hooks & Behavioral Rules
5Init, Review & Gaps
6Cheat Sheet & Next Steps

Iron Laws

  1. ONE section at a time — never dump all content at once
  2. User controls pace — always offer to stop between sections
  3. Clean formatting — use tables and code blocks, not walls of text
  4. NEVER skip the user’s questions — tutorial is interactive, not a monologue; if the user asks a question mid-section, answer it before continuing

Closing Message

After Section 6 (or when user stops):

You're all set! Try `/phx:plan` with your next feature to see the workflow in action.
Run `/phx:intro --section N` anytime to revisit a specific section.

Notes

  • This runs in main conversation context (not a subagent)
  • Reference file is readable since skill runs in user’s session
  • Keep tone welcoming but concise — developers don’t want fluff