skills.rest
hashicorp
hashicorpOFFICIAL
Explore all skills by this author →
WebsiteGitHub

skill-advisor

Analyze documents to detect issues and recommend relevant skills for remediation.

78|252|Updated Feb 7, 2024
Search Tags:#automation#workflow#documentation#guidance#discovery#analyze#skill-recommendation
One-click install
npx skills add https://github.com/hashicorp/web-unified-docs --skill skill-advisor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-advisor
Source: https://github.com/hashicorp/web-unified-docs/tree/main/content/well-architected-framework/docs/.claude/skills/skill-advisor
Command: npx skills add https://github.com/hashicorp/web-unified-docs --skill skill-advisor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams discover and apply the most relevant skills for documentation issues by analyzing content and surfacing targeted guidance, reducing time to remediation and enabling consistent practices.

Core Features & Use Cases

  • Real-time skill recommendations: analyzes documents and suggests appropriate skills based on detected issues.
  • Workflow guidance: provides suggested sequences for common tasks (new documents, pre-commit, full review).
  • Usage templates: shows examples of commands and how to apply skills to typical scenarios.

Quick Start

Use the skill to surface recommendations for a document:

  • /skill-advisor docs/file.mdx
  • /skill-advisor docs/file.mdx --explain
  • /skill-advisor docs/file.mdx --auto-suggest

Frequently Asked Questions about skill-advisor

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

FAQPage Schema
How do I get skill recommendations for documentation issues?▼

Skill recommendations for documentation issues are generated by analyzing document content to detect gaps and encoding requirements into actionable prompts with usage examples and prioritization heuristics.

What is the best way to automate workflow guidance for editing documents?▼

Automating workflow guidance for editing documents involves providing suggested sequences for common tasks like new documents, pre-commit checks, and full reviews to guide corrective actions and workflow planning.

Can I use auto-suggest for pre-commit document reviews?▼

Yes, you can use auto-suggest for pre-commit document reviews by applying the workflow guidance feature to provide suggested sequences and usage templates that show how to apply skills to typical scenarios.

Does the skill discovery process work for onboarding workflows?▼

Skill discovery works for onboarding workflows by analyzing content and detecting gaps where skill suggestions guide corrective actions, encoding requirements into actionable prompts and guides for rapid remediation.

How do I analyze content gaps and generate usage templates for documentation?▼

Analyzing content gaps to generate usage templates requires encoding requirements into actionable prompts and guides that include recommended commands, usage examples, and prioritization heuristics for rapid remediation.

Related Skills

Explore More Content & Communication Skills→
hashicorphashicorp
78

compare-docs

Compare MDX or Markdown documentation files to identify structural, content, and style gaps.

Official
Basic
HAR5HA-7663HAR5HA-7663

critique

Quantify UX issues and generate prioritized Nielsen heuristics reports.

Community
Advanced
zircotezircote
5

adr-integration

Integrate ADRs into CI/CD pipelines and documentation workflows.

Community
Advanced
arbazkhan971arbazkhan971
26

a11y

Identify accessibility issues and generate WCAG 2.1 remediation guidance.

Community
Advanced