# Send Describe Design to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "describe-design", "name": "Describe Design", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/ziad-hsn/describe-design", "canonicalUrl": "https://clawhub.ai/ziad-hsn/describe-design", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/describe-design", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=describe-design", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "describe-design", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-02T12:08:52.698Z", "expiresAt": "2026-05-09T12:08:52.698Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=describe-design", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=describe-design", "contentDisposition": "attachment; filename=\"describe-design-0.1.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "describe-design" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/describe-design" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/describe-design", "downloadUrl": "https://openagent3.xyz/downloads/describe-design", "agentUrl": "https://openagent3.xyz/skills/describe-design/agent", "manifestUrl": "https://openagent3.xyz/skills/describe-design/agent.json", "briefUrl": "https://openagent3.xyz/skills/describe-design/agent.md" } } ``` ## Documentation ### Describe Design Research a codebase and produce an architectural document describing how features or systems work. The output is a markdown file organized for both human readers and future AI agents. ### Stage 1: Scope Definition Understand what to document before exploring: Ask what feature, system, or component to document. Clarify the target audience (developers, AI agents, or both). Confirm the codebase location if not obvious from context. ### Stage 2: Initial Exploration Explore the codebase broadly to build a mental model. Use lightweight, fast exploration methods when available (in Claude Code, for example, use a Haiku Explore subagent): Scan directory structure and identify key entry points. Read README, config files, and existing documentation. Identify the main files and modules related to the feature. Build a mental model of codebase organization. Present a high-level outline to the user: ## Proposed Outline 1. [Component A] - Brief description 2. [Component B] - Brief description 3. [Component C] - Brief description * Have I correctly captured the scope of the research? Reply "yes" to continue. * Otherwise, please let me know what I've misunderstood. When the user confirms the scope, move on to deep research. ### Stage 3: Deep Research For each component in the approved outline: Trace code paths from entry points. Identify dependencies and interactions between components. Note configuration options and where they're defined. Find where data is stored or persisted. Build a code reference index (file paths + key function/class names). Try to rely on the initial code exploration for much of this information. Read additional files as needed. If the scope changed considerably in Stage 2, you can engage a second code exploration subagent. When to Stop Exploring You're ready to draft when you can: Trace the happy path — Follow a typical request/action from entry point to completion without gaps. Name the boundaries — Clearly state what's in scope and what's external. Draw the diagram — Sketch the architecture without placeholder boxes. Answer "what talks to what?" — For each component, you know its inputs and outputs. Signs you're not done: Uncertainty: "I think this connects to..." or "probably calls..." Unresolved references: Found imports/calls to modules you haven't examined. Missing edges: Can't explain how data gets from component A to B. Signs you've gone too far: Reading every file in a directory instead of representative samples. Tracing into external libraries or framework internals. Exploring implementation details that don't affect architecture. ### Stage 4: Document Draft Generate the document following the template below. Present the draft to the user for review and iterate based on feedback. If available, use the AskUserQuestion tool to request user input on key decisions. ### Stage 5: Finalize Confirm the file location before writing. You may propose a path based on repository conventions (e.g., docs/architecture/, ARCHITECTURE.md), but NEVER write the file without explicit user confirmation of the location. If the user provided a path upfront, that counts as confirmation. Write the final document to the confirmed location. ### Document Template The following template provides a starting point. Adapt it to fit the feature being documented — omit sections that don't apply, add sections for unique aspects, and adjust the structure to best serve the target audience. # [Feature/System Name] Architecture ## Overview [1-2 paragraph summary of what this feature/system does and why it exists] ## Architecture Diagram \`\`\`mermaid flowchart TD A[Entry Point] --> B[Component] B --> C[Data Store] \`\`\` ## Components ### [Component Name] **Purpose**: [What it does] **Location**: \`path/to/file.ext\` **Key Functions**: - \`functionName()\` - Brief description - \`anotherFunction()\` - Brief description **Interactions**: - Receives input from: [Component] - Sends output to: [Component] ## Data Flow [Description of how data moves through the system, from input to output] ## Configuration [How features are enabled, disabled, or configured. Include file paths and environment variables.] ## Code References | Component | File | Key Symbols | |-----------|------|-------------| | Auth | \`src/auth/index.ts\` | \`authenticate()\`, \`AuthConfig\` | | Cache | \`src/cache/redis.ts\` | \`CacheManager\`, \`invalidate()\` | ## Glossary | Term | Definition | |------|------------| | [Term] | [Project-specific definition] | ### Code Reference Conventions Use stable references that survive refactoring: Paths: Use relative paths from repository root (src/auth/login.ts) Symbols: Reference function and class names, not line numbers Format: path/to/file.ext with key symbols listed separately Anchors: Use search patterns when helpful (handleAuth function in auth/) Avoid: Copying code: Never paste code into the document. Code goes stale immediately; the document should be a guide that points readers to the source. Describe what code does, then reference where to find it. Line numbers: They change with every edit. Absolute paths: Use repository-relative paths only. ### Mermaid Diagrams Use Mermaid for architecture visualizations: Flowcharts for component relationships: flowchart TD A[Client] --> B[API Gateway] B --> C[Service] C --> D[(Database)] Sequence diagrams for request flows: sequenceDiagram Client->>API: Request API->>Service: Process Service-->>API: Response API-->>Client: Result Keep diagrams focused on the specific feature being documented. Avoid overcrowding with unrelated components. ### Writing Guidelines Describe, never copy: Explain what code does and where to find it. Readers who need implementation details will read the actual source — which is always current. Structure for scanning: Use headers, tables, and lists for quick navigation. Be specific: Include actual file paths, function names, and config keys. Serve two audiences: Write clearly for humans; use consistent structure for AI. Stay current: Note any assumptions about code state or version. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: ziad-hsn - Version: 0.1.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-02T12:08:52.698Z - Expires at: 2026-05-09T12:08:52.698Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/describe-design) - [Send to Agent page](https://openagent3.xyz/skills/describe-design/agent) - [JSON manifest](https://openagent3.xyz/skills/describe-design/agent.json) - [Markdown brief](https://openagent3.xyz/skills/describe-design/agent.md) - [Download page](https://openagent3.xyz/downloads/describe-design)