Agent skill
session-to-agent
Converts interactive Claude Code or GitHub Copilot session goals and processes into a reusable goal-seeking agent with memory. Extracts goals, constraints, and approaches from session transcripts and generates agent prompts via the amplihack goal_agent_generator CLI.
Install this agent skill to your Project
npx add-skill https://github.com/rysweet/amplihack/tree/main/amplifier-bundle/skills/session-to-agent
SKILL.md
Session-to-Agent Skill
Convert an interactive coding session into a reusable goal-seeking agent with
memory. The skill reads session transcripts, extracts goals and patterns, and
generates a complete agent via amplihack new.
Quick Start
Step 1: Invoke the skill
User: /session-to-agent
Or describe what you want:
User: Turn this session into a reusable agent
Step 2: The skill extracts from the current session
It analyzes the session transcript to identify:
- Primary goal and sub-goals
- Constraints (technical, operational, time)
- Tools and commands used
- Patterns and strategies observed
- Domain knowledge gained during the session
Step 3: A goal-seeking agent is generated
The skill writes a prompt.md file and runs:
amplihack new --file prompt.md --sdk copilot --enable-memory
The generated agent can be re-run autonomously to repeat or extend the session's workflow.
What It Extracts
| Category | Examples |
|---|---|
| Primary Goal | "Implement JWT authentication for the REST API" |
| Sub-Goals | Token generation, middleware, refresh flow, tests |
| Constraints | Must use RS256, tokens expire in 1h, no external IdP |
| Tools Used | pytest, ruff, git, curl, Bash, Read, Edit |
| Patterns | Outside-in TDD, error-first validation, retry logic |
| Domain Knowledge | JWT spec details, library quirks, API contract rules |
| Success Criteria | All tests pass, CI green, security review approved |
Customizing the Generated Agent
After generation, you can refine the agent by editing:
prompt.md-- the goal description and constraintsplan.yaml-- the execution phases and dependenciesskills.yaml-- the required skills and tool mappingsmetadata.json-- SDK, memory, and multi-agent settings
Re-run the generator after edits:
amplihack new --file prompt.md --sdk copilot --enable-memory
Memory Export (Optional)
When --enable-memory is used, the skill can optionally export the current
session's Kuzu memory database as the agent's initial knowledge base. This
seeds the new agent with facts, discoveries, and context from the session
that created it.
# Export is offered interactively after agent generation
# Or specify explicitly:
amplihack new --file prompt.md --enable-memory --sdk copilot
When to Use This Skill
- After completing a multi-step workflow you want to repeat
- When a session reveals a reusable process worth automating
- To hand off a workflow to a colleague as a runnable agent
- To create a CI/CD or SRE automation agent from manual steps
- When session knowledge should persist as an executable artifact
When NOT to Use This Skill
- For trivial single-command tasks (use a script instead)
- When the session was exploratory with no clear repeatable goal
- When the workflow is already captured as a recipe or agent
Supporting Files
| Need | File |
|---|---|
| Full extraction algorithm and templates | reference.md |
| Worked examples with real sessions | examples.md |
| Goal-seeking agent design guidance | goal-seeking-agent-pattern skill |
| Knowledge extraction from sessions | knowledge-extractor skill |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
chemist-analyst
Analyzes events through chemistry lens using molecular structure, reaction mechanisms, thermodynamics, kinetics, and analytical techniques (spectroscopy, chromatography, mass spectrometry). Provides insights on chemical processes, material properties, reaction pathways, synthesis, and analytical methods. Use when: Chemical reactions, material analysis, synthesis planning, process optimization, environmental chemistry. Evaluates: Molecular structure, reaction mechanisms, yield, selectivity, safety, environmental impact.
learning-path-builder
Creates personalized learning paths for technologies, frameworks, or concepts. Use for user-interactive session only for onboarding new technologies, hackathon skill-building, or personal development planning. Not for use in automated development or investigation. Sequences resources (docs, tutorials, exercises) based on current skill level and learning goals. Adapts to learning style: hands-on, theory-first, project-based.
gh-work-report
Generates comprehensive GitHub activity reports across all authenticated accounts. Gathers repos, PRs, features, and themes for configurable time periods (1/5/7/30/90 days). Produces shareable markdown with tables, mermaid charts, and executive summaries. Can create a private repo with GitHub Actions automation and GitHub Pages aggregation site. Use when: "github report", "work report", "activity summary", "what did I work on", "gh-work-report", "show my github activity".
pr-review-assistant
Philosophy-aware PR reviews checking alignment with amplihack principles. Use when reviewing PRs to ensure ruthless simplicity, modular design, and zero-BS implementation. Suggests simplifications, identifies over-engineering, verifies brick module structure. Posts detailed, constructive review comments with specific file:line references.
code-smell-detector
Identifies anti-patterns specific to amplihack philosophy. Use when reviewing code for quality issues or refactoring. Detects: over-abstraction, complex inheritance, large functions (>50 lines), tight coupling, missing __all__ exports. Provides specific fixes and explanations for each smell.
biologist-analyst
Analyzes living systems and biological phenomena through biological lens using evolution, molecular biology, ecology, and systems biology frameworks. Provides insights on mechanisms, adaptations, interactions, and life processes. Use when: Biological systems, health issues, evolutionary questions, ecological problems, biotechnology. Evaluates: Function, structure, heredity, evolution, interactions, molecular mechanisms.
Didn't find tool you were looking for?