Skip to content

Conversation

@peterschmidt85
Copy link
Contributor

@peterschmidt85 peterschmidt85 commented Jan 31, 2026

Summary

  • Add SKILL.md for AI coding assistants (Cursor, Codex, etc.) to work with dstack
  • Generate llms.txt and llms-full.txt automatically from mkdocs nav
  • Every documentation page now has a .md version available
  • Fix REST API docs generation (swagger was not included)

Install skill

npx skills add dstackai/dstack

…es properly with correct repo edit URL; removed from a legacy llmstxt mkdocs plugin; added skill.md stub (content to be added)
@peterschmidt85 peterschmidt85 added the docs Improvements or additions to documentation label Jan 31, 2026
peterschmidt85 and others added 5 commits January 31, 2026 01:36
Create _config.yml file in site directory to ensure Jekyll includes
the .well-known directory. This complements the .nojekyll file and
ensures the skills discovery infrastructure is properly deployed.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
peterschmidt85 and others added 2 commits January 31, 2026 16:23
Add include-hidden-files: true to upload-artifact action to ensure
.nojekyll and .well-known directory are included in the build artifact.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Remove trailing newline from description field in skills index.json
to match expected format.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
peterschmidt85 and others added 2 commits January 31, 2026 16:42
The npx skills tool fetches SKILL.md (uppercase) from the URL,
so we need to serve the file with that exact case.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Copy the skill file as both skill.md and SKILL.md at the site root
to support both URL variants.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
peterschmidt85 and others added 3 commits January 31, 2026 17:07
- Prefer --logs flag with dstack attach
- Document dstack apply confirmation flow and streaming behavior
- Prefer naming run configurations
- Prefer modifying configs over passing CLI parameters
- Use -y flag for confirmed delete/stop operations
- Note that commands may require confirmation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@peterschmidt85 peterschmidt85 marked this pull request as ready for review January 31, 2026 16:13
peterschmidt85 and others added 8 commits January 31, 2026 17:20
- Add generated openapi.json to source directory so render_swagger can find it
- Enable allow_arbitrary_locations in render_swagger config
- Gen-files plugin will keep the file updated during builds

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
…s using YAML frontmatter.

- Introduce a custom build system for generating llms.txt and llms-full.txt from documentation files.
- Add openapi.json to .gitignore to prevent it from being tracked.
- Remove outdated llms.txt file as it is now generated dynamically.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@peterschmidt85 peterschmidt85 merged commit 1dc6121 into master Jan 31, 2026
30 checks passed
@peterschmidt85 peterschmidt85 deleted the dstack-skill-md branch January 31, 2026 21:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants