ansible-markdown-docs

Fetch Ansible documentation pages from docs.ansible.com as Markdown for agent context.

8|7|Updated Feb 14, 2023
One-click install
npx skills add https://github.com/eclipse-slm/slm --skill ansible-markdown-docs-eclipse-slm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ansible-markdown-docs
Source: https://github.com/eclipse-slm/slm/tree/main/.agents/skills/ansible-markdown-docs
Command: npx skills add https://github.com/eclipse-slm/slm --skill ansible-markdown-docs-eclipse-slm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Answering Ansible questions accurately often requires checking the official documentation, but browsing docs.ansible.com manually interrupts your workflow. This Skill retrieves the relevant documentation page as Markdown so the agent can answer with authoritative, up-to-date information. ## Core Features & Use Cases - Direct URL Fetching: Provide any docs.ansible.com URL and get its content as Markdown via curl with the Accept: text/markdown header. - Topic-Based Lookup: Describe an Ansible topic and the skill resolves it to the right documentation page using a site-scoped web search. - URL Validation & Error Handling: Only fetches from docs.ansible.com, detects HTML or empty responses, and suggests alternatives when retrieval fails. - Use Case: You ask "What are the Ansible community package collection requirements?" and the skill finds the official page, fetches it, and summarizes the requirements for you. ## Quick Start Look up the official Ansible documentation for playbook basics and summarize what a play is.

Frequently Asked Questions about ansible-markdown-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch Ansible documentation as Markdown?▼

Run curl with the header Accept: text/markdown against a docs.ansible.com URL, for example curl -s -m 30 <url> -H "Accept: text/markdown". The Read the Docs backend returns the page content as Markdown instead of HTML.

How do I find the right Ansible docs page for a topic?▼

Perform a web search scoped with site:docs.ansible.com followed by your topic keywords, then select the most relevant result URL. If no confident match appears, provide the exact docs.ansible.com URL directly.

Can I fetch documentation from sites other than docs.ansible.com?▼

No, the skill validates every URL and only fetches pages beginning with https://docs.ansible.com/. Requests to other domains are refused, and you must provide a valid docs.ansible.com URL or rephrase the topic.

Why does the Ansible docs fetch return HTML instead of Markdown?▼

Some pages do not support Markdown output, so the response starts with <!DOCTYPE or <html. In that case, try an alternative URL from the search results or provide the exact page URL directly.

What happens when the Ansible documentation page is very large?▼

The full response is never truncated or piped to head. Large content is saved to a temporary file and referenced by path so the agent can process the complete documentation.