-
Notifications
You must be signed in to change notification settings - Fork 9
docs: update AI section, skills, and add markdown-access and llms-txt pages #229
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from 10 commits
2f82d4f
52c053d
f62548d
399ec7a
b4e1466
292c831
f23b7ac
2bdfb2b
930dce1
94ae9f9
3cbcd9a
9068db7
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,41 @@ | ||
| --- | ||
| title: 'llms.txt' | ||
| description: 'Use the Checkly llms.txt file to discover and crawl all available documentation pages as markdown.' | ||
| sidebarTitle: 'llms.txt' | ||
| --- | ||
|
|
||
| The [llms.txt standard](https://llmstxt.org/) provides a machine-readable index of all available documentation pages. Checkly publishes an `llms.txt` file at [`checklyhq.com/llms.txt`](https://www.checklyhq.com/llms.txt) that lists every documentation page with its markdown URL and a short description. | ||
|
|
||
| ```txt llms.txt (first 15 lines) | ||
| # Checkly Docs | ||
|
|
||
| ## Docs | ||
|
|
||
| - [Changing your email or password in Checkly](https://checklyhq.com/docs/admin/changing-your-email-password.md): Learn how to change your email address or password in your Checkly account | ||
| - [Creating an API key in Checkly](https://checklyhq.com/docs/admin/creating-api-key.md): Learn how to create and manage user and service API keys for the Checkly API and CLI | ||
| - [Adding team members to your Checkly account](https://checklyhq.com/docs/admin/team-management/adding-team-members.md): Learn how to invite team members to join your Checkly account and manage team collaboration | ||
| - [Using Microsoft Entra ID for Single Sign-on in Checkly](https://checklyhq.com/docs/admin/team-management/microsoft-azure-ad.md): This page illustrates the standard procedure to follow in order to get started with Microsoft Entra ID SSO (formerly Azure AD) on Checkly. | ||
| - [Multi-Factor Authentication in Checkly](https://checklyhq.com/docs/admin/team-management/multi-factor-authentication.md): Learn how to set up and manage multi-factor authentication for enhanced account security | ||
| - [Using Okta for Single Sign-on in Checkly](https://checklyhq.com/docs/admin/team-management/okta.md): This page illustrates the standard procedure to follow in order to get started with Okta SSO on Checkly. | ||
| - [Role Based Access Control in Checkly](https://checklyhq.com/docs/admin/team-management/rbac.md): Checkly roles and permissions for team members | ||
| - [Removing team members from your Checkly account](https://checklyhq.com/docs/admin/team-management/removing-team-members.md): Learn how to remove team members from your Checkly account and understand how it affects your billing | ||
| - [Using SAML for Single Sign-On in Checkly](https://checklyhq.com/docs/admin/team-management/saml-sso.md): Learn how to set up SAML-based SSO for your Checkly account with supported identity providers | ||
| - [Using SCIM provisioning in Checkly](https://checklyhq.com/docs/admin/team-management/scim-provisioning.md): Learn how to set up SCIM provisioning for Checkly using your identity provider | ||
| - [Team management in Checkly](https://checklyhq.com/docs/admin/team-management.md): Manage your team and collaborate effectively in Checkly | ||
| ``` | ||
|
|
||
| Use the `llms.txt` file to crawl and index the entire Checkly documentation. Every link in the file points to [the `.md` version of the page](/ai/markdown-access#md-endpoints), so you can fetch each URL directly to get the markdown content. | ||
|
|
||
| ```bash | ||
| # Fetch the llms.txt index | ||
| curl https://www.checklyhq.com/llms.txt | ||
|
|
||
| # Fetch a specific page from the index | ||
| curl https://checklyhq.com/docs/browser-checks.md | ||
| ``` | ||
|
|
||
| ## Additional resources | ||
|
|
||
| - [Markdown Access](/ai/markdown-access) | ||
| - [Checkly Skills](/ai/skills) | ||
| - [Checkly Rules](/ai/rules) | ||
|
stefanjudis marked this conversation as resolved.
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,87 @@ | ||
| --- | ||
| title: 'Markdown Access' | ||
| description: 'Access Checkly documentation as markdown to use with AI assistants and coding agents.' | ||
| sidebarTitle: 'Markdown Access' | ||
| --- | ||
|
|
||
| Every page in the Checkly documentation is available as markdown. This makes it easy to feed specific documentation pages into AI assistants like Claude, ChatGPT, Cursor, or any other AI tool. | ||
|
|
||
| ## .md endpoints | ||
|
|
||
| Append `.md` to any documentation URL to get the markdown version of that page. | ||
|
|
||
| **Example:** | ||
|
|
||
| - **HTML:** `https://www.checklyhq.com/docs/what-is-checkly/` | ||
| - **Markdown:** `https://www.checklyhq.com/docs/what-is-checkly.md` | ||
|
|
||
| The markdown version includes the full page content in plain markdown, code blocks, links preserved as markdown links, and tables formatted as markdown tables. | ||
|
|
||
| ```bash | ||
| # Fetch documentation content with curl | ||
| curl https://www.checklyhq.com/docs/what-is-checkly.md | ||
|
|
||
| # Pipe directly to your clipboard | ||
| curl https://www.checklyhq.com/docs/what-is-checkly.md | pbcopy | ||
| ``` | ||
|
|
||
| ## Content negotiation | ||
|
|
||
| You can also request markdown by setting the `Accept` header to `text/markdown`: | ||
|
|
||
| ```bash | ||
| curl -H "Accept: text/markdown" https://www.checklyhq.com/docs/what-is-checkly/ | ||
| ``` | ||
|
|
||
| This is useful when integrating with tools or scripts that set request headers programmatically. | ||
|
|
||
| <Tip> | ||
| Modern coding agents set [these headers automatically when querying documentation](https://www.checklyhq.com/blog/state-of-ai-agent-content-negotation/). | ||
|
stefanjudis marked this conversation as resolved.
|
||
| </Tip> | ||
|
|
||
| ## Copy as Markdown button | ||
|
|
||
| Every documentation page includes a **Copy as Markdown** button at the top of the page sidebar. Click it to copy the full page content as markdown to your clipboard. | ||
|
|
||
| This is the fastest way to grab documentation for a specific topic and paste it into your AI assistant's context. | ||
|
|
||
| ## Feeding documentation to AI assistants | ||
|
|
||
| Here are some patterns for using Checkly documentation with AI tools: | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Is this the best way to give agents context? I'd assume modern agents can query the URL directly, which might be easier than having to copy a page's MD? (Asking since I am mostly curious and not too familiar with how this stuff works 🙂)
Collaborator
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Great call. removed rephrased. :) |
||
|
|
||
| ### Single page context | ||
|
|
||
| When you need help with a specific feature, copy that page's markdown and include it in your prompt: | ||
|
|
||
| ```text | ||
| Here is the Checkly Browser Checks documentation: | ||
|
|
||
| [paste markdown content] | ||
|
|
||
| Based on this, how do I set up a browser check with a custom user agent? | ||
| ``` | ||
|
|
||
| ### Multiple page context | ||
|
|
||
| For complex tasks, combine multiple relevant pages: | ||
|
|
||
| ```text | ||
| I need to set up monitoring for my API. Here is the relevant documentation: | ||
|
|
||
| ## API Checks | ||
| [paste api-checks.md] | ||
|
|
||
| ## Alerting | ||
| [paste alerting.md] | ||
|
|
||
| Help me set this up step by step. | ||
| ``` | ||
|
|
||
| ### Built-in agent documentation | ||
|
|
||
| The [`checkly skills` command](/cli/checkly-skills) provides documentation optimized for your agent. Use it with [the Checkly Skills](/ai/skills) to see the best results. | ||
|
|
||
| ## Additional resources | ||
|
|
||
| - [Checkly Skills](/ai/skills) | ||
| - [Checkly Rules](/ai/rules) | ||
|
stefanjudis marked this conversation as resolved.
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,11 +1,16 @@ | ||
| <Card title="Create new checks, alert channels or other constructs" horizontal> | ||
| "Can you create a new `BrowserCheck` monitoring `example.com`" | ||
| </Card> | ||
|
|
||
| <Card title="Gather information about the current monitoring setup" horizontal> | ||
| "What are the currently used monitoring locations?" | ||
| "Can you set up a new `BrowserCheck` for `example.com`?" | ||
| </Card> | ||
|
|
||
| <Card title="Bulk-update your monitoring resources" horizontal> | ||
| "Can you change all checks to run every 5 minutes instead of every 10 minutes?" | ||
| </Card> | ||
|
|
||
| <Card title="Gather information about alerts and your monitoring setup" horizontal> | ||
| "I just received an alert. Can you tell me details about the failing checks?" | ||
| </Card> | ||
|
|
||
| <Card title="Handle and communicate incidents" horizontal> | ||
| "Can you please open an incident and investigate a fix?" | ||
| </Card> | ||
|
|
Uh oh!
There was an error while loading. Please reload this page.