thalovant-skillkit

Write a Thalovant skill without writing the plumbing.

pip install "thalovant-skillkit[skill]"
thalovant-skillkit new garden-watering

That writes a complete skill — package, locales, tests, packaging, CI — that passes its own checks before you touch it.

The skill

from thalovant_skillkit.skill import ThalovantFallbackSkill


class GardenWateringSkill(ThalovantFallbackSkill):
    FALLBACK_PRIORITY = 98

    def can_answer(self, message) -> bool:
        return self.mentions(self.utterance(message), "GardenWateringKeyword")

    def reply(self, utterance, lang, context):
        return self.dialog("garden.watering", lang)

reply is the one method most skills need. What it returns is spoken on the hub and shown in the showroom, so the two cannot drift apart.

A test

from thalovant_skillkit.testing import message

def test_it_hears_its_keyword():
    assert GardenWateringSkill().can_answer(message("water the garden"))

def test_it_ignores_the_rest():
    assert not GardenWateringSkill().can_answer(message("set a timer"))

Keeping it right

thalovant-skillkit check

Every locale complete, placeholders matching, packaging sound, priority in band. The same check runs in the CI the scaffold writes for you.

thalovant-skillkit check --model

Every skill's intents are trained into one classifier on the hub, so a sentence you publish must not already be another skill's. --model compares your .intent files with the fleet's model on the Hugging Face Hub (thalovant/thalovant-m2v-intents, public): a sentence another skill already publishes fails, on the line, naming the owner; a sentence the classifier reads as another skill's warns, with its confidence. The scaffold's CI does this on every push and tells you which line to change.

What you get


`self.utterance(msg)`	what was said
`self.lang_of(msg)`	the language of this utterance
`self.location_of(msg)`	where the house is
`self.mentions(text, "Voc")`	does the text mention this vocabulary — plurals included
`self.dialog("name", lang)`	a line from `locale/<lang>/dialog/name.dialog`
`self.setting("key", default)`	one skill setting
`self.reply(utterance, lang, ctx)`	your answer; spoken and previewed from one place

Everything on OVOSSkill still works — self.speak, self.speak_dialog, self.voc_match, the intent decorators. Nothing here replaces them.

Guide: docs.thalovant.com/developers/writing-a-skill

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

thalovant_skillkit-0.5.0.tar.gz (67.1 kB view details)

Uploaded Sep 8, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

thalovant_skillkit-0.5.0-py3-none-any.whl (55.2 kB view details)

Uploaded Sep 8, 2026 Python 3

File details

Details for the file thalovant_skillkit-0.5.0.tar.gz.

File metadata

Download URL: thalovant_skillkit-0.5.0.tar.gz
Upload date: Sep 8, 2026
Size: 67.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for thalovant_skillkit-0.5.0.tar.gz
Algorithm	Hash digest
SHA256	`8832bbbdd8b01e7064ccea8c23f5c98183c765b2ec54838b18df33fb10a63d4a`
MD5	`3302ff2f885784cc0582afe6c5fe4c41`
BLAKE2b-256	`179aa6e7b24b7014896917568582e97829fa3f02bc05e9fe0fbac75ac6168d8a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for thalovant_skillkit-0.5.0.tar.gz:

Publisher: publish.yml on thalovant/thalovant-skillkit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: thalovant_skillkit-0.5.0.tar.gz
- Subject digest: 8832bbbdd8b01e7064ccea8c23f5c98183c765b2ec54838b18df33fb10a63d4a
- Sigstore transparency entry: 2761384827
- Sigstore integration time: Sep 8, 2026
Source repository:
- Permalink: thalovant/thalovant-skillkit@3e62e2052e262f440e0909150cd9cb61d24ab017
- Branch / Tag: refs/tags/v0.5.0
- Owner: https://github.com/thalovant
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@3e62e2052e262f440e0909150cd9cb61d24ab017
- Trigger Event: release