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.

Stars 45
Forks 28

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:

bash
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 constraints
  • plan.yaml -- the execution phases and dependencies
  • skills.yaml -- the required skills and tool mappings
  • metadata.json -- SDK, memory, and multi-agent settings

Re-run the generator after edits:

bash
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.

bash
# 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

Expand your agent's capabilities with these related and highly-rated skills.

rysweet/amplihack

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.

45 28
Explore
rysweet/amplihack

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.

45 28
Explore
rysweet/amplihack

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".

45 28
Explore
rysweet/amplihack

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.

45 28
Explore
rysweet/amplihack

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.

45 28
Explore
rysweet/amplihack

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.

45 28
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results