i-am-bee/agentstack/agentstack-wrapper-2
Trust tier 2
- community
Source check pending
Checking that the SKILL.md file is still in the repository.
Wraps existing Python agent as Agent Stack service using agentstack-sdk with minimal compatibility changes and no business-logic rewrites. Use when migrating, wrapping, or deploying an existing plain Python or framework-based agent to Agent Stack; not for non-Python runtimes or building new agent from scratch.
Install
npx vskill@latest install i-am-bee/agentstack/agentstack-wrapper-2SKILL.md
Agent Stack Wrapper
Integration guide for wrapping Python agents for Agent Stack platform.
Table of Contents
- Security Requirements
- Constraints (must follow)
- Integration Workflow Checklist
- Readiness Check (before Step 1)
- Step 1 – Study the Project
- Step 2 – Classify the Agent
- Step 3 – Add and Install Dependencies
- Step 4 – Create the Server Wrapper & Entrypoint
- Step 5 – Wire LLM / Services via Extensions
- Step 6 – Error Handling
- Step 7 – Forms (Single-Turn Structured Input)
- Step 7b – Adapt File Inputs
- Step 8 – Configuration Variables & Secrets
- Step 9 – Agent Output
- Step 10 – Use Platform Extensions
- Step 11 – Update README
- Anti-Patterns
- Failure Conditions
- Finalization Report (Required)
- Verification Checklist
Security Requirements
- Never run remote scripts or untrusted code.
- Use trusted package metadata, pin versions, and audit installed
agentstack-sdk/a2a-sdk. - Handle sensitive values only through declared Agent Stack extensions.
- Never log, print, persist, or expose secret values.
- Never send secrets to untrusted intermediaries or endpoints not required by the wrapped agent contract.
- If installing anything via
pip, always use the-qqflag to suppress unnecessary output.
Constraints (must follow)
| ID | Rule | |
|---|---|---|
| C1 | No business-logic changes. Only modify code for Agent Stack compatibility. | |
| C2 | Strict minimal changes. Do not add auth, Dockerfile (containerization is optional and separate), telemetry, or platform middleware unless explicitly requested. If an agent works with simple text, don't force a Form. If it works with env vars, refactor minimally. | |
| C3 | Cleanup temp files. If the agent downloads or creates helper files at runtime, add a cleanup step before the function returns. | |
| C4 | Prioritize Public Access (No redundant tokens). Only use the Secrets extension if the secret is strictly mandatory for the agent's core functionality and no public/anonymous access is viable. Do not add secrets or tokens that increase configuration burden if they were optional in the original agent (e.g., optional GitHub token). Preserve existing optional auth behavior unless removal is explicitly approved and documented as a behavior change. API keys must be passed explicitly, never read from env vars. For required third-party API credentials, Secrets or Env Variables extension is mandatory in the wrapped path. | |
| C5 | Detect existing tooling. If the project uses requirements.txt, add agentstack-sdk~=<VERSION> there. If it uses pyproject.toml, add it there. Add a2a-sdk only when the project manages it directly, and keep it compatible with the chosen agentstack-sdk version. Never force uv or create duplicate manifests. | |
| C6 | Package-First Source of Truth for Imports. The Inline Package Search script defined in references/dependencies.md holds absolute priority for discovering correct import paths, class names, and types. You MUST run this script to map imports before relying on local reference files or online documentation. Do not guess imports or follow documented paths blindly if they conflict with the installed package. | |
| C7 | Documentation-Secondary Authority. Local skill files in the references/ folder and online documentation are the primary authority for _behavior, logic, and choice of extensions_, but they are secondary to package introspection for _exact implementation details_ like import paths. | |
| C8 | Fallback and Validation Order. Use local source inspection and package introspection first for imports. Keep runtime/package verification as a final validation step after implementation. | |
| C9 | Structured Parameters to Forms. For single-turn agents with named parameters, map them to an initial_form using FormServiceExtensionSpec.demand(initial_form=...). | |
| C10 | Remove CLI arguments. Remove all argparse or sys.argv logic. Replace mandatory CLI inputs with initial_form items, AgentStack Settings Extension (for runtime options), or AgentStack Env Variables. | |
| C11 | Approval gate for business-logic changes. If compatibility requires business-logic changes, stop and request explicit approval with justification before proceeding. | |
| C12 | Preserve original helpers. Do not delete original business-logic helpers unless strictly required. If removal is necessary, document why. | |
| C13 | Optional extension safety. Service/UI extensions are optional. Check presence/data before use (e.g., if llm and llm.data ...). | |
| C14 | No secret exposure. Never log, print, persist, or echo secret values (API keys, tokens, passwords). Redact sensitive values in logs and errors. |
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/agentstack-wrapper/SKILL.md
Popularity
- Repository stars
- 1,080
- Repository forks
- 170
- 7-day trend score
- 35
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 26 Apr 2026, 6 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/i-am-bee/agentstack/agentstack-wrapper-2)