Skip to content

Update doc skill for sub llms files + add query params#13

Open
jackieros wants to merge 5 commits into
mainfrom
doc/update-for-sub-llms-files
Open

Update doc skill for sub llms files + add query params#13
jackieros wants to merge 5 commits into
mainfrom
doc/update-for-sub-llms-files

Conversation

@jackieros
Copy link
Copy Markdown
Member

@jackieros jackieros commented May 31, 2026

  • Update skill to match new llms-per-product structure
  • Add install source & skill name query params
  • Update version

@jackieros jackieros changed the title Doc/update for sub llms files Update doc skill for sub llms files + add query params May 31, 2026
## Example Workflows

**Example 2: Transformation question**
**Example 1: Transformation question**
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shouldn't we be relying on the transformation skill for transformation questions? I probably need to update that skill now for the new llms-image-and-video-apis.txt too.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point - maybe we should suggest that here -

Also, in your transformation skill, pls also add the query params to any URLs - i.e. direct links to the transformation reference.md or any other specific doc md files as well as the llms-image-and-video.txt (didn't remember that we pointed to llms.txt from yours though...?)

Comment thread skills/cloudinary-docs/SKILL.md Outdated
| Cloudinary Assets (DAM) | Digital Asset Management (DAM), Media Library, folders, metadata, collections, creative workflows, portals, digital rights, or any Cloudinary Console or UI-based asset management needs | https://cloudinary.com/documentation/llms-cloudinary-assets.txt?install_source=skillspack&asset=docs-skill |
| MediaFlows | PowerFlows, EasyFlows, workflow automation, flow blocks | https://cloudinary.com/documentation/llms-mediaflows.txt?install_source=skillspack&asset=docs-skill |
| Integrations | Cloudinary integrations with 3rd party apps (WordPress, Shopify, Contentful, Salesforce, Adobe, etc.) or questions about implementing new integrations | https://cloudinary.com/documentation/llms-integrations.txt?install_source=skillspack&asset=docs-skill |
| Cross-product or unsure | — | https://cloudinary.com/documentation/llms.txt?install_source=skillspack&asset=docs-skill |
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The - in the topic column is a dead end. We might want to replace it with something like:
Multiple products, general, or unclear topic

3. **Reflect on the user's question** and identify which specific documentation URLs would be most relevant
4. **Navigate** to the specific relevant documentation URLs from the llms.txt index (you can make multiple calls)
5. **Use the fetched documentation** to provide a comprehensive, accurate answer or code implementation. When relevant, use in conjunction with more specialized Cloudinary skills like cloudinary-transformations. The best practices defined in the specialized skills should guide which doc instructions to use.
1. **Identify the product area** from the user's question using the Sub-file Index above
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

An llm might not re-read the table on each invocation. Perhaps we can make this clearer and say, "Refer to the Sub-file Index table above and identify the matching row."

jackieros added 2 commits June 4, 2026 23:01
* main:
  fix: react sign upload and preset name (#16)
  Fix transformation skill issues (10, 11 and 12) (#14)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants