Enable CTO Agent to Import External Agents from GitHub Repos

[siddhijadhav27]

Problem

Currently, the CTO agent cannot import agents from external GitHub repositories like agency-agents. This limits the ability to extend the agent ecosystem with pre-built community agents.

Current Behavior

• CTO agent fails when asked to add agents from GitHub repos
• Error: adapter_failed, tool_call_id not found, max iterations exceeded
• No skill exists to read and parse external agent repositories

Expected Behavior

• CTO agent should read any public GitHub repo containing agent definitions
• Automatically convert external agent format to Paperclip schema
• Create new agents in the workspace with proper configuration
• Validate imported agents before activation

Proposed Solution

Phase 1: Create github-repo-reader Skill

• Location: skills/github-repo-reader/
• Fetch agent definitions from public GitHub repos via GitHub API
• Parse README.md, agent definition files, and metadata
• Extract: name, role, description, capabilities, adapter config

Phase 2: Create agent-format-converter Skill

• Location: skills/agent-format-converter/
• Map external fields to Paperclip schema:
  • name -> name
  • role -> role
  • description -> capabilities
  • skills -> desiredSkills
• Handle format variations from different agent frameworks

Phase 3: Modify paperclip-create-agent Skill

• Add source parameter: github, local, template
• If source=github, call github-repo-reader -> agent-format-converter -> create agent
• Add validation step before activation

Phase 4: Database and Permissions

• Ensure CTO has can_create_agents permission
• Add API keys for GitHub API access
• Store import history for audit

Phase 5: Testing and Verification

• Import test repo with 3+ agents
• Verify agents appear in agent list
• Test agent assignment and execution
• Document import process

Acceptance Criteria

• CTO can import agents from any public GitHub repo
• Imported agents are properly formatted and functional
• Failed imports show clear error messages
• User is notified of successful import with agent list
• Documentation updated with import workflow

Related

• Repository: https://github.com/msitarzewski/agency-agents
• Current blocker: CTO agent lacks execution tools and skills