dotagent:port-fish-agent

Generate an agent.toml from meta.json to migrate Fish agents to dotagent.

3|1|Updated May 19, 2026
One-click install
npx skills add https://github.com/avelino/dotagent --skill dotagent-port-fish-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotagent:port-fish-agent
Source: https://github.com/avelino/dotagent/tree/main/.claude/skills/port-fish-agent
Command: npx skills add https://github.com/avelino/dotagent --skill dotagent-port-fish-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrates a Fish-based agent workflow to dotagent without rewriting the core agent.fish.

Core Features & Use Cases

  • Port the existing lib/agent.fish to a dotagent-compatible agent.toml, preserving behavior and heartbeat semantics.
  • Replace direct Fish orchestration with dotagent scheduling for the agent lifecycle.
  • Use when converting a dotfiles-based agent into a dotagent-managed agent to gain consistent scheduling and notifications.

Quick Start

Run the migration workflow by providing the agent folder path, the meta.json, and the agent.fish to generate an agent.toml and integrate with dotagent.

Frequently Asked Questions about dotagent:port-fish-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a Fish-based agent to dotagent without rewriting the core agent.fish?

To migrate a Fish-based agent to dotagent, you generate an agent.toml from the existing meta.json and integrate it with the current heartbeat and scheduling. This preserves the original agent behavior and enables seamless dotagent deployment without rewriting the core agent.fish.

What is the process of porting an agent.fish workflow to an agent.toml configuration?

Porting an agent.fish workflow to an agent.toml configuration involves mapping fields from the existing meta.json to the dotagent.toml format. This replaces direct Fish orchestration with dotagent scheduling for the agent lifecycle while preserving heartbeat semantics.

Can I use dotagent scheduling for my existing Fish dotfiles agent without losing heartbeat semantics?

Yes, you can use dotagent scheduling to manage your existing Fish dotfiles agent. The migration enforces mapping from meta.json fields to dotagent.toml and preserves the original heartbeat semantics, ensuring consistent scheduling and notifications.

What is the best way to convert a dotfiles-based agent into a dotagent-managed agent?

The best way to convert a dotfiles-based agent into a dotagent-managed agent is by generating an agent.toml from the meta.json file. This approach replaces direct Fish orchestration with dotagent scheduling while maintaining the original agent behavior.

Do I need to provide a meta.json file to port an agent.fish to dotagent?

Yes, you need to provide the meta.json file to port an agent.fish to dotagent. The migration workflow requires the meta.json to enforce the correct mapping of fields to the dotagent.toml configuration.