> For the complete documentation index, see [llms.txt](https://docs.tessl.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tessl.io/use/understand-your-skill-estate.md).

# Understand your organization's context

How to connect an SCM account so Tessl scans your repositories and shows your Organization's Context and Findings.

Connect an SCM account and Tessl scans your repositories, indexes the skills and configuration it finds as **Context**, and surfaces **Findings** you can act on. This is the primary way to see what exists across your Organization.

***

SCM connections are managed at the Organization level. Connecting one needs the Organization admin role. Organization members and admins can view **Context** and **Findings**. See [Roles](/administrators/roles.md) for the full breakdown.

### Connect an SCM account

Tessl supports these source-control providers:

* **GitHub** (GitHub App)
* **GitLab** (access token)
* **Bitbucket**

**To connect:**

1. Open the Tessl web app.
2. Select your Organization from the dropdown at the top of the sidebar, then go to **Settings**, then **Integrations**.
3. Under **Source control**, select **Add** next to your provider and follow the prompts to authorize Tessl.

Connecting authorizes Tessl to read from the provider. Depending on provisioning availability, Tessl may then start a first scan of the repositories in scope. Scan provisioning is best-effort and separate from creating the connection, so a successful connection does not guarantee that a scan has started or finished. The connection page shows scan status. An Organization admin can retry a failed scan or set the **Scan scope** there.

### See your Context and Findings

Once a scan has run:

* Open **Context** in the sidebar to see the skills and configuration Tessl found across your connected repositories, including which repository each item lives in.
* Open **Findings** to see the issues Tessl surfaced, ranked by severity.
* **Home** gives you an overview across your Organization.

To control which repositories Tessl scans, open the connection under **Settings**, then **Integrations**, and set the **Scan scope**. For GitHub-specific setup, see [Connect Tessl to GitHub](/distribute/connect-tessl-to-github.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.tessl.io/use/understand-your-skill-estate.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
