Create documentation tasks when a GitHub README changes
Use README updates as a cue to review the wider documentation experience.
Trigger
GitHub Repository README Changed
Triggers when the README file in a specific repository directory changes. Monitors the README in a configurable directory and branch/tag/commit. The payload includes the current README metadata (filename, path, SHA, size, URLs), the previous and current git blob SHAs, and a list of which tracked fields changed.
Action
Create Task
Tool to create a new user task in Habitica. Use after gathering task details like text, type, and optional properties.
Why this helps
A quick README edit can leave related docs, onboarding, or announcements out of sync.
- Prompts documentation review
- Prevents drift
- Keeps changes discoverable
Setup
Build it in a few focused steps.
- 1Connect GitHub and Habitica to Notis once.
- 2Create a new automation from Automations.
- 3Tell Notis to create a documentation review task when the repository README changes.
- 4Select the README-change trigger and a report channel.
- 5Update a test README to check the workflow.
Questions about this workflow
Can it monitor a README in a subdirectory?
Yes. The GitHub trigger supports a configurable repository directory.
When this happens · Trigger
Do this · Action
Supported Triggers and Actions
Notis builds workflows that link GitHub to Habitica. A trigger fires from one place; an action lands in another.
GitHub triggers
Habitica actions
Recurring trigger
Notis starts this workflow on a schedule, such as daily, weekly, or during business hours.
Add Task to Challenge
Tool to add a new task to a specified challenge. Use when you need to programmatically create a challenge task after the challenge is set up and you have its ID.
Webhook trigger
Notis starts this workflow when an external tool or custom backend sends an HTTP request.
Cancel Subscription
Attempts to cancel the authenticated user's subscription. Since Habitica's public API does not provide a cancellation endpoint, this action checks the current subscription state and returns: - success=True with a no-op message if there is no active subscription - success=False with guidance to cancel via the website/app if a subscription appears active
New Workflow Artifact Created
Triggers when a new workflow artifact is created in a GitHub repository. Monitors for newly created GitHub Actions workflow artifacts. Optionally filters by artifact name to restrict monitoring to specific artifacts.
Create Challenge
Tool to create a new challenge. Use when you need to start a challenge in a specific group with title, summary, and optional tasks.
Branch Changed
Triggers when a GitHub branch changes. Monitors a specific branch for: - New commits pushed (head commit SHA changes) - Protection status toggled (branch becomes protected or unprotected) - Protection settings changed, including: required status checks and their enforcement level, admin enforcement, required pull request reviews (dismiss stale reviews, code owner reviews, approving review count, last push approval), required linear history, force push allowance, deletion allowance, conversation resolution, branch locking, and fork syncing.
Create Habitica Group
Tool to create a Habitica party or guild. Use when you want to initialize a new group with name, type, and optional privacy and description.
New Branch Created
Triggers when a new branch is created in a GitHub repository. Detects newly created branches. Deleted branches do not fire events.
Create Tag
Tool to create a new tag. Use after determining the desired tag name.
Check Run Status / Conclusion Changed
Triggers when a specific GitHub check run changes its status or conclusion. Monitors a single check run for changes to: status (queued, in_progress, completed, etc.), conclusion (success, failure, neutral, cancelled, skipped, timed_out, action_required), started_at, and completed_at.
Create Task
Tool to create a new user task in Habitica. Use after gathering task details like text, type, and optional properties.
Check Suite Status / Conclusion Changed
Triggers when a GitHub check suite changes its status or conclusion for a given ref. Monitors all check suites associated with a git reference (branch, tag, or commit SHA) for changes to status (queued, in_progress, completed, etc.) and conclusion (success, failure, neutral, cancelled, skipped, timed_out, action_required, startup_failure, stale). Optionally filters by GitHub App ID.
Create Webhook
Tool to create a new webhook for taskActivity events. Use when you need real-time notifications of task creation, updates, deletion, or scoring.
New Code Scanning Alert Created
Triggers when a new code scanning alert is created in a repository. Fires an event for each newly created code scanning alert detected in the configured repository. Alerts can be filtered by Git reference, scanning tool, state, and severity. The payload includes the alert number, rule details, tool information, state, severity, and the location of the most recent instance.
Delete a Habitica Challenge
Tool to delete a challenge. Use when you need to permanently remove a challenge after confirmation.
Connect any two apps with Notis in the middle.
GitHub and Habitica, or any other combination from 1,000+ integrations.
When this happens · Trigger
Do this · Action
Save your first hour today.
7-day trial of any paid plan, with 20$ of usage included.
No card. Works with personal or business Habitica.