Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

feat(adapter/amazon-q): Amazon Q Developer CLI skill runtime

Closed
#320 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
38/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Quiet
Tech stack
aws
Domain
cli, tooling

Research direction

Read docs/rfcs/RFC-AI-0004.md and inspect the existing .claude/skills/ shape first. Consult the Amazon Q CLI and Q agents references, then verify how skills, tools/* bridges, allow-lists, trust prompts, and interactive confirmations map to Q. Done means the mapping and invocation pattern work and the sandbox and HITL behavior are documented.

Written by the indexing model from the issue text.

Description

capability:platform enhancement family:tools good first issue

Goal: Bring Amazon Q Developer CLI (q) to feature parity with Claude Code as a skill runtime. Grounds: RFC-AI-0004 Principle 3 — Vendor neutrality.

Why Amazon Q: Default agentic CLI in many AWS-shop environments — corporate adopters, federal / regulated environments where Amazon Q is the only sanctioned LLM tool. Several ASF projects with AWS-aligned committer bases have asked about Q compatibility. Coverage matters less for individual maintainers, more for organisational adoption.

What "parity" means:

  • Skills under .claude/skills/<name>/SKILL.md are invokable from q (Q Developer CLI)
  • The tools/* bridges are reachable — q supports custom tools via its agent configuration
  • Sandbox parity: q has its own command-permission model (allow-lists, "trust" prompts) — document the mapping
  • HITL primitives: q supports interactive confirmation for tool use — verify and document

Suggested approach:

  • Map SKILL.md → Q's agent configuration format (~/.aws/amazonq/agents/<name>.json + system prompts)
  • Document skill-invocation pattern
  • Map sandbox parity — q allowlists are the native fit for the framework's command-permission discipline

Reference:

Dominant language
Python
Stars
113
Forks
95
Avg merge
10h 56m
Merged PRs (30d)
348

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from apache/magpie

All issues in apache/magpie

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.