how-it-works
Skill from atlassian/atlassian-mcp-server
Install
npx skills add atlassian/atlassian-mcp-server --skill how-it-works
Runs the open skills CLI and installs the skill for your agent (Claude Code, Codex, Cursor …). Alternatively copy the skill folder into .claude/skills/ or upload it in Claude.ai under Settings → Skills.
As a Claude Code plugin
/plugin marketplace add anthropics/claude-plugins-official
/plugin install atlassian@atlassian
This skill is part of the plugin “atlassian”. In Claude Code the plugin installs it together with the plugin’s other skills, commands and hooks.
What does the how-it-works skill do?
Description from the SKILL.md in the source repository.
Works with Atlassian
Questions about how-it-works
What does the how-it-works skill do?
Explain how a product behaviour works in plain language from the code that decides it. Searches connected Bitbucket and GitHub code, checks Confluence, Jira, chat and docs, and finds ownership from repository metadata and Compass. Answers in the conversation first with a short answer, a code-linked trace, settings and unknowns, documentation disagreements and owners; adds an account checklist and proposed reply for a customer question or ticket. Offers the existing HTML report on request and publication only when Atlassian Artifacts is available and requested. Use when support, customer success, product or docs asks how something works, why the product behaves that way, what happens when, or /how-it-works. For an expert, use whos-the-expert. For an active incident, use incident-brief.
How do I install how-it-works?
In a terminal: npx skills add atlassian/atlassian-mcp-server --skill how-it-works. The skills CLI asks which agents to install it for. In Claude.ai you can upload the skill folder as a ZIP under Settings → Skills.
Which agents can use how-it-works?
Skills use the open SKILL.md format, which Claude Code, Claude.ai, the Claude API, OpenAI Codex, Cursor, Gemini CLI and other agents support.
Is how-it-works safe to use?
Our automatic check found patterns worth a look (see “Check”). That is not proof of anything bad – read the SKILL.md and scripts before installing.
Which tool is how-it-works for?
how-it-works comes from the makers of Atlassian and helps your agent work with it.
More skills from atlassian/atlassian-mcp-server
Find source, callers, and API consumers outside the local workspace using the Atlassian MCP code search operations (searchCode, getCodeFile, scanCodeRepo, listCodeDirectory).
Analyze meeting notes to find action items and create Jira tasks for assigned work. When an agent needs to: (1) Create Jira tasks or tickets from meeting notes, (2) Extract or find …
Generate project status reports from Jira issues and publish to Confluence. When an agent needs to: (1) Create a status report for a project, (2) Summarize project progress or updates, (3) Generate …
Create a visual Jira sprint dashboard from Jira project, space, sprint, board, filter, JQL, work item keys, or Jira URL data.
Search across company knowledge bases (Confluence, Jira, internal docs) to find and explain internal concepts, processes, and technical details.
Automatically convert Confluence specification documents into structured Jira backlogs with Epics and implementation tickets.
Intelligently triage bug reports and error messages by searching for duplicates in Jira and offering to create new issues or add comments to existing ones.
Assess whether a release, fix version or milestone is ready to ship using Teamwork Graph across Jira, Projects, Confluence, connected code, deployments and chat.
Related skills in Development
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.
Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes: Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what …
Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo.
Guidance for instrumenting webapps with Azure Application Insights. Provides telemetry patterns, SDK setup, and configuration references.
Analyze Azure resource groups and generate detailed Mermaid architecture diagrams showing the relationships between individual resources. WHEN: create architecture diagram, visualize Azure resources, show resource relationships, generate Mermaid diagram, analyze resource group …
Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: semantic caching, token limit, content safety, load balancing, AI model governance, MCP rate limiting, jailbreak detection …
Troubleshoot and resolve issues with Azure Messaging SDKs for Event Hubs and Service Bus. Covers connection failures, authentication errors, message processing issues, and SDK configuration problems.