Add Codex skill with usage guidance and drawing templates#30
Conversation
Add a Codex skill at .agents/skills/alchemist/ with: - SKILL.md: full usage guide for the alchemist Typst package - agents/openai.yaml: skill metadata for auto-discovery - references/api.md: complete API reference - references/patterns.md: 15 molecule drawing templates
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Adds an “alchemist” skill package with reference documentation and agent metadata to help generate Typst chemical structure drawings using the @preview/alchemist package.
Changes:
- Added a new “Drawing Patterns” reference with common molecule templates.
- Added an API reference documenting core functions, links, configuration defaults, and bindings.
- Added skill metadata (
SKILL.md) and an OpenAI agent interface descriptor (openai.yaml).
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 9 comments.
| File | Description |
|---|---|
| .agents/skills/alchemist/references/patterns.md | New cookbook-style Typst snippets for drawing common structures with alchemist. |
| .agents/skills/alchemist/references/api.md | New API reference and default configuration documentation for alchemist. |
| .agents/skills/alchemist/agents/openai.yaml | Declares agent display name/description/default prompt for the skill. |
| .agents/skills/alchemist/SKILL.md | Skill overview and usage guide linking to the reference docs. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
There are multiple issues in the skill api (cf copilot comments and mine) and the ai is doing some anti-paterns. Can you fix the issues? |
- Fix function signatures in api.md to use named-arg notation (colons) for named parameters and clarify positional args - Fix argument ordering in patterns.md examples: positional args before named args - Fix misleading single(double, triple, ...) table entry in SKILL.md to list link functions as alternatives Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
This commit still doesn't fix all the issues. I pinpointed all the obvious ones, but I certainly missed some others. Send a message when everything is fixed. |
Closes #29
Adds a Codex skill at .agents/skills/alchemist/\ to help AI assistants provide accurate guidance for drawing chemical skeletal formulas with the alchemist Typst package.
Changes:
The skill uses progressive disclosure: the SKILL.md covers the core workflow and points to reference files that load on demand when Codex needs deeper API details or ready-made patterns to adapt.