# Summary

## Description

This plugin extends the filtering abilities of the [Bitbucket Branch
Source
Plugin](https://wiki.jenkins.io/display/JENKINS/Bitbucket+Branch+Source+Plugin).

This filter will ignore events that the source branch last commit
contains the tags \[skip ci\] or \[ci skip\]. It provides a similar
functionality as [Circle CI
does](https://circleci.com/docs/1.0/skip-a-build/).

The filtering is only performed for change request events, so push
events to non-pull requests will be always run.

## Warning!

The current implementation works over "tagging" the relevant pull
request job as excluded. This way, the job will be disabled (won't be
executable via the UI) and might get erased if an Orphaned Child policy
kicks in, losing the whole PR run history.

## Usage

When defining a new Bitbucket Team/Project, include an additional
behaviour (placed under the "Additional" separator). 

![](docs/images/Screenshot_from_2017-09-25_13.33.52.png)

  

  

This behaviour is not configurable. It will just show a simple inline
help icon:

![](docs/images/Screenshot_from_2017-09-25_13.34.11.png){height="250"}